Re: [boost] [Git] Documentation for Git and Modular Boost conversion

Subject: Re: [boost] [Git] Documentation for Git and Modular Boost conversion
From: Beman Dawes (bdawes_at_[hidden])
Date: 2012-12-11 09:51:01

On Mon, Dec 10, 2012 at 2:07 PM, Julian Gonggrijp <j.gonggrijp_at_[hidden]> wrote:
> Beman Dawes wrote:
>
>> Yes, but the feeling was that documentation had to be provided before
>> making such an announcement. That's why the docs are being developed
>> this week.
>
> Ah, of course. Excuse me.
>
>> I also added a reference to the workflow page for those interested in git-flow.
>
> If I understand correctly you put it over there and not on the
> resources page because it's a command line tool which not everyone is
> interested in. On the other hand: not everyone is interested in a
> Windows GUI tool like TortoiseGit either. Why not just put the git-
> flow tool on the resources page as well? It will be quite helpful for
> those using the command line, given that GitFlow is adopted by Boost.

I'm deferring workflow discussion, and thus GitFlow, to a separate
page to avoid piling on too many new ideas for developers who have
never used Git before.

Also, "the best is the enemy of the good" applies to this doc effort.
We need to get "good enough" docs up for developers now, rather than
superb docs up later:-)

Thanks,

--Beman