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

Re: Notes for DDP writers

On Sun, 14 Feb 1999 10:09:23 -0500, "James A. Treacy" <treacy@debian.org> said:
> On Sun, Feb 14, 1999 at 01:48:17PM +0100, Josip Rodin wrote:
>> On Sun, Feb 14, 1999 at 01:32:35PM +0100, Josip Rodin wrote: > What
>> exactly needs to be done? I'd say we should rearrange the whole >
>> site, move all the documents on the site to /doc/ subdirectory,
>> Was this a stupidly put sentence or what? :) I meant rearranging
>> documents on *va* (not just website) that are currently spread all
>> over the place, and arrange them in /doc.

> One of the things that needs to be done is to make the presentation
> of the docs as uniform as possible. That is why both Adam and I feel
> that there should be a person from debian-doc managing the
> documentation section of the web site.

In addition, I'd like to see at least a *plan* for how to better
automate the integration between the DDP cvs area and the
www.debian.org pages where appropriate.  I don't know if cvs
branching/tagging will be required so that unreleased versions of

We also need a plan for managing translations of manuals.  Maybe we're
just throwing translated versions of the manuals into the same
directory with the properly named files for content negotiation (i.e.,
foo.en.html, foo.de.html); maybe we're putting translated SGML into
the DDP CVS area.  I've asked the debiandoc-sgml maintainer to add
content-negotiated file naming conventions support into that package
(specifically, into debiandoc2html, at least, hopefully the other
scripts as well) -- for that see Bug#33354.

> Are you volunteering?

I hope he is!  He seems to have a good grasp on the structure of the
current website.

.....Adam Di Carlo....adam@onShore.com.....<URL:http://www.onShore.com/>

Reply to: