Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Collect documentation for standard GH-pages components #803

Open
dabrahams opened this issue Nov 27, 2021 · 1 comment
Open

Collect documentation for standard GH-pages components #803

dabrahams opened this issue Nov 27, 2021 · 1 comment

Comments

@dabrahams
Copy link

I understand the reasons outlined in #651 for not automatically upgrading to Jekyll 4.0 along with all the consequent dependencies, among them Liquid and Sass. The problem now is that as all of these projects continue to evolve, it becomes harder and harder to learn what capabilities are natively supported by GH-pages—one has to dig extra hard into any part of the the documentation to discover whether any particular claim is true for a GH-pages site. Consequently, GH-pages becomes harder and harder to use. Ease-of-use is one of the things that has made GH-pages so incredibly popular and powerful over the years, so not paying attention to the erosion of this quality is a threat to the system's continued relevance.

Personally I would prefer if GH would avoid breaking old websites by adding a "legacy jekyll" checkbox to repository configuration—frankly it seems easier than what I'm about to suggest—but failing that, I'd like to see GitHub maintain a site that collects all the documentation for versions of jekyll and the tools on which it's built that are actually supported.

Thanks for your attention.

@janbrasna
Copy link

The versions used are listed here: https://pages.github.com/versions/

"Legacy Jekyll" is practically being used now, as any non-Actions GH Pages builds are today called "Classic", so that gives the idea why the gems probably won't ever get upgraded beyond security-related bumps or minor/patch versions to fix tiny things. #651 (comment), actions/jekyll-build-pages#104 (comment), #651 (comment)

Screen Shot 2024-03-17 at 20 26 34

That should probably be pinned somewhere. TL;DR that reads to me like:

  • you have a bunch of .MDs a want them published without knowing the SSG/stack? Pages Classic will do that for you.
  • you tweak the configs, work with anything Jekyll-related locally, can serve/build etc.? Set up Pages via Actions instead, and use whatever you want.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants