Re: Bad Man Page URLs

From: David E. Wheeler <david@justatheory.com>
Date: Apr 26, 2012, 22:11 UTC
Message-ID: <BEA084BA-739D-4D73-80C0-FE2FC1598D9F@justatheory.com>
In-Reply-To: <CAP2yMa+mjvFmVwXjrB7FRaD2=iMCCPENWAOoCG5TCsqFdsCDxQ@mail.gmail.com>

On Apr 26, 2012, at 2:58 PM, Scott Chacon wrote:

Show 8 quoted lines

> Yes, we are very close to launching a big redesign of git-scm.com.
> The manpages will be automatically updated on that site, you can
> certainly link to them there.
> 
> If you want to preview what it's going to look like and the URL
> structure, you can check out the current working version here:
> 
> http://git-scm.herokuapp.com/docs/git-fetch

Wow, the new site looks *awesome*! :-)

Show 10 quoted lines

> There are a number of known bugs and I want to make it much faster
> before I officially launch it and redirect DNS, but you can get an
> idea of how it will be structured and what it will look like.  If you
> want to start generating docs with static urls for man pages, they can
> be of the form: http://git-scm.com/docs/git-command
> 
> You can also put a version number after them to permalink them at a
> certain version:
> 
> http://git-scm.herokuapp.com/docs/git-fetch/1.7.3.2

Very nice. I only found one of the links from the manpage there, though:

  Everyday Git
  http://git-scm.herokuapp.com/docs/everyday.html

Here are the others on gitmanual.org (maybe I just couldn't find them on the new site?):

  User Manual
  http://www.gitmanual.org/user-manual.html

  git concepts chapter of the user-manual
  http://www.gitmanual.org/user-manual.html#git-concepts

  howto
  http://www.gitmanual.org/howto-index.html

And this one is a broken link on gitmanual.org and other places on the internetz.

  GIT API documentation
  ????

Best,

David