-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 I think we might consider a split on documentation target
On Thursday 23 October 2003 09:30, Sven Vermeulen wrote: > (1) Link all documentation on the documentation index, but keep the > documentation where it is. This however has one big disadvantage, > which is that only a very very very small part of the documentation > team can do editing on those documents (one person most of the time). > The result is that installation-related documents are quickly outdated > (our installation guide changes a lot, and with the upcoming handbook > this won't change :) because the documentation team can't update the > related documents. Developer related documentation can go here, however we need to get some good procedure for publishing links to these documents in an index. > > (2) Move all documentation in the documentation repository and link > those on the index page. This however has one big disadvantage, which > is that only a small part of the respective project (clusters, > hardened, metastructure) have access to the documentation for updates. > User documentation should go here. It is more critical on correctness and readability. It probably also creates more confusion if it not maintained by documentation. > In the eyes of the documentation development, this latter is > preferred: at least one person of each project has (or should have) > access to the documentation cvs (see the "Project Doc Editor" at > http://www.gentoo.org/proj/en/gdp). Further more, updates to > documentation shouldn't be a one-man change -- a second "opinion" must > be established (we just call it reviewing) so that no major mistakes > are made (we are all human). > Are there objections if I would suggest to implement the second > proposal (i.e. migrate documentation to the documentation directory)? For user related docs not at all. I think that developer related documentation (esp. that which is still in state of development) can stay in the project directories. However I agree with robbat2 on exploring ACL's Paul - -- Paul de Vrieze Gentoo Developer Mail: [EMAIL PROTECTED] Homepage: http://www.devrieze.net -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/l5Z1bKx5DBjWFdsRArSFAJ4qapZKiLAxHSp8XmbgpsopaHH2hACfYTPW JlOYnwo2infMW7tijv3/5mY= =vrCM -----END PGP SIGNATURE----- -- [EMAIL PROTECTED] mailing list
