CD image (FTP)
Hi, excuse me to draw attention to the old Denis's post.
I think this was conclusive decision on how documentation for the CD
image need to be organized.
I think new revised narrow scope Policy Proposal needs to follow this
approach.
1. DDP will create documentation part of CD image somewhere. (FTP
access)
2. This documentation does not contain all DDP but contain core part.
3. File arrangement is optimized for localizing (Per language if I
recall right. I think Javi stated that on this thread.)
Only change needed to current one by Denis may be publishing location
for upcoming Policy Proposal.
On Tue, Dec 10, 2002 at 03:24:11PM +0100, Denis Barbier wrote:
> On Tue, Dec 10, 2002 at 05:40:50AM -0800, Osamu Aoki wrote:
> > On Tue, Dec 10, 2002 at 11:13:37AM +0100, Josip Rodin wrote:
> > > On Tue, Dec 10, 2002 at 09:16:59AM +0100, Javier Fernández-Sanguino Pe?a wrote:
> > > > > All the byhand stuff for docs should have been removed in favour of Javier's
> > > > > new debian/doc/ layout, but there was no automated scheme for updating that,
> > > > > either.
> > > >
> > > > Also, the FTP maintainers did not want to use this layout.
> > >
> > > I still think the main factor was that it wasn't automated.
> >
> > How difficult is it to automate this?
> > 1) Agree on file arrangements and file types to be published.
> > --> Finish ddp-policy on FTP
> > 2) Agree on which target name to make FTP contents ("ftp"?) which will
> > be used in each document's Makefile:
> > --> patch all the /ddp/manuals.sgml/<packagename>/Makefile
> > 3) Create a new target ("ftp"?) in /ddp/manuals.sgml/Makefile which
> > makes all the documents with target "ftp" and run Denis's indexing
> > script
> > --> patch
> > 4) Ask FTP account holder to run cron which checkout DDP CVS and build
> > documents daily.
> > --> script can be rip-off from current DDP CVS script :-)
>
> http://www-master.debian.org/~barbier/doc-debian-intro/ is updated from
> time to time. It contains a minimal set of documents so that FTP
> masters won't complain that it wastes too much bandwidth.
> Furthermore I see no reason to build all documents, they are available
> in Debian packages.
>
> Denis
--
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
Osamu Aoki <osamu@debian.org> Cupertino CA USA, GPG-key: A8061F32
.''`. Debian Reference: post-installation user's guide for non-developers
: :' : http://qref.sf.net and http://people.debian.org/~osamu
`. `' "Our Priorities are Our Users and Free Software" --- Social Contract
Reply to: