[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Documentation co-ordinator



treacy@debian.org wrote:
...
  >Currently most Debian documenatation on the web pages is grabbed from the FT
      >P
  >archive. This is because not all documentation maintainers were forwarding
  >the latest version to the DDP. Having the master copy in CVS on va will go
  >a long way to fixing that. Synchronization problems would all but disappear
  >if the latest copy of all the different versions were created by checking th
      >em
  >out of CVS (daily in some cases).

All of the documentation on the webpage is currently outside the DDP; we
will need to get its various authors to co-ordinate with us.  Ideally, this
would involve their putting it into DDP's cvs repository.

  >Christian did put some thought into the organization of the DDP so I
  >wouldn't start changing things until you have a good reason.
  >Any decisions regarding placement should take into account that the
  >documentation appears in the following places:
  >   within the DDP web pages
  >   on the Debian web pages
  >   under /doc on the ftp archive

These 3 can be all the same file(s), no?

  >   in /usr/doc

There are the packages: doc-debian (Santiago Vila), doc-linux (Dirk
Eddelbuettel), debian-policy (orphaned, but probably the Technical
Committee), packaging-manual (orphaned), developers-reference (orphaned).
These appear to be the only ones (apart from the non-English documentation
packages) that contain documentation that is not specific to a software
package.

The orphaned packages are those previously maintained by Christian Schwarz.
Would someone like to take them on?

Ideally, the maintainers will check in the package contents under CVS so
that they can be incorporated into the documentation system.

  >That's on top of trying to have documents that work in the following
  >formats: html, txt and ps.

These should be automatically generated into a consistent scheme
-- 
Oliver Elphick                                Oliver.Elphick@lfix.co.uk
Isle of Wight                              http://www.lfix.co.uk/oliver
               PGP key from public servers; key ID 32B8FAA1
                 ========================================
     "Because he himself suffered when he was tempted, he
      is able to help those who are being tempted."       
                                        Hebrews 2:18 



--  
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org


Reply to: