git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 1/1] documentation: remove empty doc files

From
Heba Waly <heba.waly@gmail.com>
Date
Oct 23, 2019, 07:23 UTC
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:
Show 13 quoted lines
>
> 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
Previous: Junio C HamanoNext: Heba Waly
Message 5 of 13 in “[Outreachy] documentation: remove empty doc files”
  1. 0/1 [Outreachy] documentation: remove empty doc filesHeba Waly via GitGitGadget, Oct 22, 2019
  2. 1/1 documentation: remove empty doc filesHeba Waly via GitGitGadget, Oct 22, 2019
  3. Emily ShafferOct 22, 2019
  4. Junio C HamanoOct 22, 2019
  5. Heba WalyOct 23, 2019
  6. Heba WalyOct 23, 2019
  7. 0/1 [Outreachy] documentation: remove empty doc filesHeba Waly via GitGitGadget, Oct 23, 2019
  8. 1/1 documentation: remove empty doc filesHeba Waly via GitGitGadget, Oct 23, 2019
  9. Emily ShafferOct 23, 2019
  10. Heba WalyOct 24, 2019
  11. 0/1 [Outreachy] documentation: remove empty doc filesHeba Waly via GitGitGadget, Oct 24, 2019
  12. 1/1 documentation: remove empty doc filesHeba Waly via GitGitGadget, Oct 24, 2019
  13. Emily ShafferOct 24, 2019

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.