From: Heba Waly <heba.waly@gmail.com>
Date: Wed, 23 Oct 2019 07:23:40 GMT
Subject: Re: [PATCH 1/1] documentation: remove empty doc files
Message-ID: <CACg5j25ANmBAUP8B+noRprqb3tgRanEyWQK8dx+QJGhKHZke6w@mail.gmail.com>
In-Reply-To: <xmqqtv80jq3n.fsf@gitster-ct.c.googlers.com>

On Wed, Oct 23, 2019 at 12:52 PM Junio C Hamano <gitster@pobox.com> wrote:
>
> Emily Shaffer <emilyshaffer@google.com> writes:
>
> > As for the content of this change, I absolutely approve. I've stumbled
> > across some of these empty docs while looking for answers before and
> > found it really demoralizing - the community is so interested in
> > teaching me how to contribute that they've sat on a TODO for 12 years?
> > :( I even held up api-grep.txt as a (bad) example in a talk I gave this
> > year. I'm happy to see these files go.
>
> I'd approve this move, too, especially if we accompanied deletion
> with addition (or verification of existence) of necessary docs
> elsewhere (perhaps in *.h headers).
Good point, although not all corresponding header files are
documented, but I'll include that in the commit message.

Thanks