Hello,

On Sun 19 May 2019 at 10:52PM +01, Ian Jackson wrote:

> Sean Whitton writes ("Bug#928666: Want dgit FAQ"):
>> control: retitle -1 want more entries in dgit faq & add links to it
>> in existing docs
>
> I really like what you have done so far.
>
>
> Maybe we want to take some of my answers in that mail thread:
>
>     Re: Preferred git branch structure when upstream moves from tarballs to 
> git
>
> In particular maybe answers to these:
>
>   why is Vcs-Git not enough for users
>
>   where does dgit fit into things
>   (answer: my diagrams of Tue, 7 May 2019 19:25:39 +0100)
>
>   should I use this git-debrebase thing too
>   (ansser: no, basically)
>
>   OK then, I want to try it out, what should I do
>
> What do you think ?

These all seem like good candidates, but I think we could probably
simplify at least some of the answers down from what you wrote in that
thread.

> I wonder if we want a survey of git workflow practices.  I frequently
> find I am not communicating properly because I don't know what
> someone's workflow is and they don't have the terminology or the
> knowledge of the problem space to understand what a "git workflow"
> even is.

Yeah, this could well be useful.  For example, I didn't realise that gbp
includes explicit support for the debian/-only workflows until the
recent thread.

Perhaps just an e-mail thread saying "here is all the workflows we think
there are, please pipe up if you know of another" ?

> Also this FAQ is aimed at Debian maintainers.  Do we need a separate
> section for users ?  For NMUers ?  Eg
>
>   I am a downstream of Debian; how should I use dgit ?
>
> (which comes up a fair amount).  But we have less of a need for a PR
> offensive there...

I think that would be a separate FAQ if anything, and it's much less
important for the time being, so let's put that aside (unless someone
really wants to write one, of course).

-- 
Sean Whitton

Attachment: signature.asc
Description: PGP signature

Reply via email to