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

Re: [RFC PATCH 0/5] git-reset documentation changes

From
Junio C Hamano <gitster@pobox.com>
Date
Jul 16, 2010, 21:00 UTC
Message-ID
<7v39vjrvl4.fsf@alter.siamese.dyndns.org>
In-Reply-To
<cover.1279273256.git.trast@student.ethz.ch>
Thomas Rast <trast@student.ethz.ch> writes:
Show 12 quoted lines
> I wrote this on the bus travelling to France, and haven't got around
> to sending it out since then.
>
> The main goal was the first patch, which redoes the 'description'
> section in the style pioneered by b831ded (Documentation/checkout:
> clarify description, 2010-06-01) in git-checkout(1).
>
> The rest are just various ideas that I'm tossing around.  I also would
> like to shorten the 'examples' section significantly if anyone sees a
> way to do that without a huge loss of explanations.  I think the
> chances that users consult the current version aren't exactly great
> because of its length.

Except for one small nit or two I mentioned in a separate message, I like the overall direction of this series.

Thanks.
Previous: Thomas Rast
Message 14 of 14 in “git-reset documentation changes”
  1. 0/5 git-reset documentation changesThomas Rast, Jul 16, 2010
  2. 1/5 Documentation/git-reset: reorder modes for soft-mixed-hard progressionThomas Rast, Jul 16, 2010
  3. 2/5 Documentation/reset: separate options by modeThomas Rast, Jul 16, 2010
  4. Junio C HamanoJul 16, 2010
  5. 0/5 git-reset documentation changesThomas Rast, Jul 18, 2010
  6. 1/5 Documentation/git-reset: reorder modes for soft-mixed-hard progressionThomas Rast, Jul 18, 2010
  7. 2/5 Documentation/reset: separate options by modeThomas Rast, Jul 18, 2010
  8. 3/5 Documentation/reset: promote 'examples' one section upThomas Rast, Jul 18, 2010
  9. 4/5 Documentation/reset: reorder examples to match descriptionThomas Rast, Jul 18, 2010
  10. 5/5 Documentation/reset: move "undo permanently" example behind "make topic"Thomas Rast, Jul 18, 2010
  11. 3/5 Documentation/reset: promote 'examples' one section upThomas Rast, Jul 16, 2010
  12. 4/5 Documentation/reset: reorder examples to match descriptionThomas Rast, Jul 16, 2010
  13. 5/5 Documentation/reset: move "undo permanently" example behind "make topic"Thomas Rast, Jul 16, 2010
  14. Junio C HamanoJul 16, 2010

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.