github / github/pages-gem

Collect documentation for standard GH-pages components

Aperta
#803 1 commento 1 reazione 0 assegnatari Vedi su GitHub
Lingua principale
Ruby
Stelle
1.9k
Fork
360
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

I understand the reasons outlined in [#651](https://github.com/github/pages-gem/issues/651#issuecomment-962031976) 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.

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

La issue non indica file, test o punti di ingresso. Inizia esaminando le problematiche di compatibilità in #651 e le versioni supportate di Jekyll, Liquid e Sass; il lavoro è completato quando un sito mantenuto raccoglie la documentazione per le versioni e gli strumenti supportati da GitHub Pages.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
github, ruby, sass
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Ferma
Chiarezza
Da chiarire
Idoneità per principianti
20/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.