Re: Notes for DDP writers
On Sun, 14 Feb 1999 10:09:23 -0500, "James A. Treacy" <firstname.lastname@example.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
.....Adam Di Carlo....adam@onShore.com.....<URL:http://www.onShore.com/>