Re: help with doc-debian package

[Osamu Aoki <osamu@debian.org>]

Hi,

Thanks Sean.

Let me make some comment.


On Thu, 2023-02-02 at 09:45 -0700, Sean Whitton wrote:
> Hello,
> 
> On Wed 01 Feb 2023 at 08:38PM +01, Joost van Baal-Ilić wrote:
> 
> > Hiya,
> > 
> > FWIW: our beloved doc-debian [1] package, which ships stuff like
> > /usr/share/doc/debian/constitution.txt.gz and
> > /usr/share/doc/debian/social-contract.txt.gz is another one of those old and
> > strange (by-hand stuff @ ftp-master, e.g.) packages in need of some extra
> > care.
> > I don't think I have time to do the necessary updates in time for the
> > freeze...
> > 
> > The work needed consists of interfacing with our infrastructure, no coding
> > or text drafting necessary.
> 
> I can adopt it if you would like.  Let me know.

If I understand correctly, we copy webwml source and create source for this deb
package manually in advance.  In a oversimplified sense:

 source of www.debian.org --> transform to create deb source. --> deb

What is better is create a source deb package as the pristine source and
generate corresponding www.debian.org pages from binary deb package content
files with cron script on www-master.d.o like debian-policy etc.  Then updating
is simpler.

 deb source package --> deb binary packages --> www.debian.org

Of course, this needs to be agreed by the party updating the constitution in
advance.

Just my thought.

Osamu