Re: Bug#481129: Bug#671503: general: APT repository format is not documented

[Ian Jackson <ijackson@chiark.greenend.org.uk>]

CC'ing the apt list deity@lists.debian.org.

Goswin von Brederlow writes ("Re: Bug#481129: Bug#671503: general: APT repository format is not documented"):
> Michal Suchanek <michal.suchanek@ruk.cuni.cz> writes:
> > [ discussions regarding documenting the apt repository format ]
> 
> I would suggest you look at existing repositories, whatever scraps of
> information is in the manuals and maybe a bit at the source and start to
> write a documentation. Once you have that offer it for review and other
> people can pitch in their bits of knowledge. Getting the current format
> documented right shouldn't be that hard if someone just starts.

Right.

> And once such a document exists it is much easier to get people do
> document changes or hit them over the head if they don't.

Can the apt maintainers confirm that once such a document exists, they
will insist that future contributions to apt which change the
repository format update the document ?

What form do the apt maintainers think the document should take ?
Should it eventually be in the apt source package or somewhere else ?

> Remember that you don't have to be 100% right in what you write. You
> only need to write a draft to start the process. Getting people to
> comment and correct any mistakes you simply don't know about is much
> much easier than getting someone else to write the whole thing.

Indeed so.

Thanks,
Ian.