Re: [PATCH] partial-clone: render design doc using asciidoc

From: Stefan Beller <sbeller@google.com>
Date: Aug 14, 2018, 23:00 UTC
Message-ID: <CAGZ79kYbmTXXwWO6Sy5ytOLS6=p=9gMzgbjdrSbJPkkQqsyJTA@mail.gmail.com>
In-Reply-To: <20180814222846.GG142615@aiede.svl.corp.google.com>

On Tue, Aug 14, 2018 at 3:28 PM Jonathan Nieder <jrnieder@gmail.com> wrote:

Show 18 quoted lines

>
> Rendered documentation can be easier to read than raw text because
> headings and emphasized phrases stand out.  Add the missing markup and
> Makefile rule required to render this design document using asciidoc.
>
> Tested by running
>
>   make -C Documentation technical/partial-clone.html
>
> and viewing the output in a browser.
>
> Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
> ---
> Today I noticed that this document wasn't available at
> https://www.kernel.org/pub/software/scm/git/docs/technical/partial-clone.html,
> so I wrote this patch.
>
> Thoughts of all kinds welcome, as always.

yay! Thanks for writing it!

...

> repack in GC has been updated to not touch promisor
> packfiles at all, and to only repack other objects.

We'd need to adapt this documentation in Jonathans series?

> -[0] https://bugs.chromium.org/p/git/issues/detail?id=2
> -    Chromium work item for: Partial Clone
> +[0] https://crbug.com/git/2
> +    Bug#2: Partial Clone

This is more than a formatting fix (I did not quite check the rest, but this stood out), but some change to the actual content?