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

Re: Migration of git-scm.com to a static web site: ready for review/testing

From
Johannes Sixt <j6t@kdbg.org>
Date
Nov 18, 2023, 09:41 UTC
Message-ID
<39f863b9-fc81-43ca-93f5-89e341e8615d@kdbg.org>
In-Reply-To
<6f7d20b4-a725-0ef9-f6d3-ff2810da9e7a@gmx.de>
Am 17.11.23 um 14:25 schrieb Johannes Schindelin:
Show 30 quoted lines
> Hi,
> 
> the idea of migrating https://git-scm.com/ from a Rails app to a static
> site has been discussed several times on this list in the past.
> 
> Thanks to the heroic, multi-year efforts of Matt Burke, Victoria Dye and
> Matthias Aßhauer, there is now a Pull Request, ready for review:
> https://github.com/git/git-scm.com/pull/1804
> 
> This Pull Request is not for the faint of heart, mainly because of the
> sheer amount of generated pages that are committed to the repository (such
> as the book, the manual pages, etc, a design decision necessary to run
> this as a static website).
> 
> These pages are generated by GitHub workflows that are intended to run on
> a schedule, and the scripts that generate them are part of the Pull
> Request. For that reason, I do not consider it necessary to review those
> generated pages, those reviews have been done in the upstream sources from
> which the pages were generated.
> 
> At this point, the patches are fairly robust and I am mainly hoping for
> help with verifying that the static site works as intended, that existing
> links will continue to work with the new site (essentially, find obscure
> references to the existing website, then insert `git.github.io/` in the
> URL and verify that it works as intended).
> 
> To that end, I deployed this branch to GitHub Pages so that anyone
> interested (hopefully many!) can have a look at
> https://git.github.io/git-scm.com/ and compare to the existing
> https://git-scm.com/.

When a transition to static pages happens, an important aspect is that external links that point into git-scm.com must not be invalidated. There are many such links in Stackoverflow answers, for example.

I checked one link:

https://git-scm.com/docs/git-rebase#Documentation/git-rebase.txt--r https://git.github.io/git-scm.com/docs/git-rebase#Documentation/git-rebase.txt--r

and it is looking very good. Thank you! I assume that keeping links working is not just a happy accident, but part of the plan.

-- Hannes
Previous: Johannes SchindelinNext: Johannes Schindelin
Message 8 of 15 in “Migration of git-scm.com to a static web site: ready for review/testing”
  1. Johannes SchindelinNov 17, 2023
  2. Todd ZullingerNov 17, 2023
  3. Johannes SchindelinNov 18, 2023
  4. Todd ZullingerNov 18, 2023
  5. Johannes SchindelinNov 21, 2023
  6. Todd ZullingerNov 28, 2023
  7. Johannes SchindelinSep 11, 2024
  8. Johannes SixtNov 18, 2023
  9. Johannes SchindelinNov 18, 2023
  10. Kaartic SivaraamNov 23, 2023
  11. Johannes SchindelinSep 11, 2024
  12. Johannes SchindelinSep 11, 2024
  13. Johannes SchindelinSep 11, 2024
  14. Toon ClaesSep 12, 2024
  15. Johannes SchindelinSep 14, 2024

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.