[debian] where to document branch layout

[Russ Allbery]

Stefano Zacchiroli <zack at debian.org> writes:

> My question is whether we have a guideline about *where* to document
> branch layout for a given package. Regarding Debian,
> debian/README.source comes to mind quickly, but its current description
> in policy does not make it clear that it is the suitable place where to
> document branch layout.

The intention is to use that file for anything that helps explain how to
make changes to a Debian source package.  I think this would qualify.

> A more general question is whether there is a fixed set of "well known"
> branch layouts that can be written down so that we can reference each
> layout with a clear name. If this is so, I believe this is the right
> place where to attempt defining such a set.

FWIW, I've been keeping notes on what I'm personally doing at:

    http://www.eyrie.org/~eagle/notes/debian/git.html

-- 
Russ Allbery (rra at stanford.edu)             <http://www.eyrie.org/~eagle/>