RFC: future directions of the documentation after the XML migration

Eitan Adler lists at eitanadler.com
Sat Sep 15 19:46:38 UTC 2012


Please note none of my remarks were objections, just questions.

On 15 September 2012 12:57, Gabor Kovesdan <gabor at freebsd.org> wrote:
> Don't people prefer using UTF-8, which just works out of the box? I
> picked it from linimon's list and looking at it I thought using the euro
> mark wasn't problematic any more.

Okay.

>>> > http://www.freebsd.org/doc/en_US.ISO8859-1/articles/version-guide/
> Seems that 1 and 4 have useful information but I think that's also
> described in Handbook. As for the lessons learned and the "current"
> releng process sections, the primary is very old information and imo not
> really relevant from an end-user perspective and the second one may have
> changed.

Okay.

>>> > http://www.freebsd.org/doc/en_US.ISO8859-1/articles/hats/
>> imp@ may want to comment here
>
> I think it is too general and very short. We have lots of hats from very
> different types and the charters give better information on them. And it
> mostly talks about things that you should know by common sense: be
> polite, make compromises, etc. Such do not carry too much "real
> information" and I think something like that is also mentioned in
> committers-guide.

Agreed. I just thought he want to comment before we remove it.

>>> > http://www.freebsd.org/doc/en_US.ISO8859-1/articles/multi-os/
>> Section 7 here is still useful I think?
>
> Are you able to technically judge if it describes the current design and
> limitations? If so, it should be moved to the sysadmin part of the handbook.

As wblock said, this article is dead. Lets remove it.


Thanks for doing the work

-- 
Eitan Adler



More information about the freebsd-doc mailing list