RFC: future directions of the documentation after the XML migration

[Gabor Kovesdan]

Em 15-09-2012 15:48, Eitan Adler escreveu:
>> http://www.freebsd.org/doc/en_US.ISO8859-1/articles/euro/
> Not an objection per se, but is this article actually out of date?
> 

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.

>> > http://www.freebsd.org/doc/en_US.ISO8859-1/articles/version-guide/
> Some of this is in the handbook, but again, is this article actually
> out of date?

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.

> 
>> > 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.

>> > 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.

Gabor