Re: What's cooking in git.git (Jul 2014, #04; Tue, 22)

From: Junio C Hamano <gitster@pobox.com>
Date: Jul 23, 2014, 18:10 UTC
Message-ID: <xmqqegxcdjzl.fsf@gitster.dls.corp.google.com>
In-Reply-To: <B6FB0C239E6E4E2489FAB9EF1C902988@PhilipOakley>

"Philip Oakley" <philipoakley@iee.org> writes:

Show 16 quoted lines

>> * po/everyday-doc (2014-01-27) 1 commit
>> - Make 'git help everyday' work
>>
>> This may make the said command to emit something, but the source is
>> not meant to be formatted into a manual pages to begin with, and
>> also its contents are a bit stale.
>
>> It may be a good first step in
>> the right direction, but needs more work to at least get the
>> mark-up right before public consumption.
>>
>> Will hold.
>>
>
> It's not clear to me which bits of mark-up are 'wrong' and must be
> reworked,

It's been too long since I wrote the above and I left it without updates (these comments are by default carried over from one issue to the next of "What's cooking" report, unless there is some development on the topic). Now I read the output (admittedly, I skimmed only the HTML version), I think the formatting / mark-up is fine.

I at the same time found various command sequences used there are rather classical and there are better ways to do the same with modern tools, which still makes me feel hesitant to promote this document without updating its contents, though.