howto-index not found

The https://git-scm.com/docs/gittutorial-2 says 'For some interesting examples of Git use, see the <a href="http://git-scm.com/docs/howto-index">howtos</a>"' but that does not exist and redirects to https://git-scm.com/docs. Where should that link be updates it point?

I found https://git-scm.com/docs/gitworkflows which looks somewhat fitting or perhaps https://github.com/git/git/tree/master/Documentation/howto.

Dennis

This E-mail is confidential. It may also be legally privileged. If you are not the addressee you may not copy, forward, disclose or use any part of it. If you have received this message in error, please delete it and all copies from your system and notify the sender immediately by return E-mail.

Internet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions. PLEASE NOTE that Freedom Communication Technologies is now a part of Astronics Test Systems (ATS) and email addresses are changing. Please update my contact info by replacing @freedomcte.com with @astronics.com to direct your messages to my new email address (for example, first.last@freedomcte.com will be updated to first.last@astronics.com)

On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis <Dennis.Bulgrien@astronics.com> wrote:

`howtos-index` does get generated by the Git project but doesn't appear to be published on the git-scm site for some reason. git-scm is maintained as a separate project[1], so the best thing to do is to report the problem there using their bug tracker[2].

[1]: https://github.com/git/git-scm.com [2]: https://github.com/git/git-scm.com/issues

Eric,

I was going to report it on github but it[1] says "Make sure this is NOT an issue about : - the Git documentation (a.k.a. man/help pages, i.e. anything with a URL starting with https://git-scm.com/docs), which should be raised with the community at https://git-scm.com/community,..."

[1]: https://github.com/git/git-scm.com/issues/new

Dennis

-----Original Message-----
From: Eric Sunshine <sunshine@sunshineco.com>
Sent: Thursday, February 4, 2021 1:59 PM
To: Bulgrien, Dennis <Dennis.Bulgrien@astronics.com>
Cc: git@vger.kernel.org
Subject: Re: howto-index not found

On Thu, Feb 4, 2021 at 2:18 PM Bulgrien, Dennis <Dennis.Bulgrien@astronics.com> wrote:

`howtos-index` does get generated by the Git project but doesn't appear to be published on the git-scm site for some reason. git-scm is maintained as a separate project[1], so the best thing to do is to report the problem there using their bug tracker[2].

[1]: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fgit%2Fgit-scm.com&amp;data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C4480515b1d654da4745e08d8c94749e0%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480655312877735%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&amp;sdata=dQ9HE8EruC2UN5mDtWVrV5eSRj9gG7K8IDb%2BZ%2FrTe7o%3D&amp;reserved=0 [2]: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fgit%2Fgit-scm.com%2Fissues&amp;data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C4480515b1d654da4745e08d8c94749e0%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480655312877735%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&amp;sdata=VG8y3gsYIEo1wsEIj%2BulX%2F6R3dacVpn%2Bzy4cnJ4ChR8%3D&amp;reserved=0

This E-mail is confidential. It may also be legally privileged. If you are not the addressee you may not copy, forward, disclose or use any part of it. If you have received this message in error, please delete it and all copies from your system and notify the sender immediately by return E-mail.

Internet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions. PLEASE NOTE that Freedom Communication Technologies is now a part of Astronics Test Systems (ATS) and email addresses are changing. Please update my contact info by replacing @freedomcte.com with @astronics.com to direct your messages to my new email address (for example, first.last@freedomcte.com will be updated to first.last@astronics.com)

On Thu, Feb 04, 2021 at 02:58:36PM -0500, Eric Sunshine wrote:

There's already an issue here:

  https://github.com/git/git-scm.com/issues/1521

But I think there's a larger problem within Git's manpages themselves. There is no manpage version of many of the pages, yet git.txt still links to them. So "man git" on my system points to to several file:// urls that doesn't exist. This is true of my custom-built Git, but I think also true for some system package setups (e.g., Debian's "git" package ships the manpages, but you don't get the html versions unless you install "git-doc" as well).

-Peff

The github tracker redirects back to this group, saying "These pages are generated from git man pages, so we have no control over it. Have you reported it to the community at https://git-scm.com/community ?"

[1]: https://github.com/git/git-scm.com/issues/1521

Dennis

-----Original Message-----
From: Jeff King <peff@peff.net>
Sent: Thursday, February 4, 2021 2:27 PM
To: Eric Sunshine <sunshine@sunshineco.com>
Cc: Bulgrien, Dennis <Dennis.Bulgrien@astronics.com>; git@vger.kernel.org
Subject: Re: howto-index not found

On Thu, Feb 04, 2021 at 02:58:36PM -0500, Eric Sunshine wrote:

There's already an issue here:

  https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fgit%2Fgit-scm.com%2Fissues%2F1521&data=04%7C01%7CDennis.Bulgrien%40astronics.com%7C35dd885da77a4dcd278c08d8c94b440e%7Ca2ce8a60084049b7938997ad811e2924%7C1%7C0%7C637480672478675488%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C2000&sdata=YnvAqClHZb3Ne5RtIpSQO%2BZI6IbgmWrqRjZhYaaUjys%3D&reserved=0

But I think there's a larger problem within Git's manpages themselves. There is no manpage version of many of the pages, yet git.txt still links to them. So "man git" on my system points to to several file:// urls that doesn't exist. This is true of my custom-built Git, but I think also true for some system package setups (e.g., Debian's "git" package ships the manpages, but you don't get the html versions unless you install "git-doc" as well).

-Peff

This E-mail is confidential. It may also be legally privileged. If you are not the addressee you may not copy, forward, disclose or use any part of it. If you have received this message in error, please delete it and all copies from your system and notify the sender immediately by return E-mail.

Internet communications cannot be guaranteed to be timely, secure, error or virus-free. The sender does not accept liability for any errors or omissions. PLEASE NOTE that Freedom Communication Technologies is now a part of Astronics Test Systems (ATS) and email addresses are changing. Please update my contact info by replacing @freedomcte.com with @astronics.com to direct your messages to my new email address (for example, first.last@freedomcte.com will be updated to first.last@astronics.com)

On Thu, Feb 04, 2021 at 08:34:18PM +0000, Bulgrien, Dennis wrote:

Yeah, there are sort of two questions here:

  - should git-scm.com be generating the howto-index, api-index, etc;
    that's an issue that would be solved there (because it has custom
    code to import and format the documentation from git.git).

  - should Documentation/git.txt be more careful about referencing
    potentially-absent html files from the manpage builds. That's an
    issue that should be solved here on the mailing list.

-Peff