Built docs repo size: split out old versions

Aperta
  • Qualcosa non va?
#1,145 0 commenti 1 reazione 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 2 giorni

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Attiva
Stack tecnologico
github
Ambito
devops, documentation

Direzione di ricerca

No specific files or tests are named. Start by locating the deploy script and gh-pages configuration mentioned in the issue, then trace how built versions are published. Done means old versions can be served from separate repositories at their existing URLs and the main pages repository is smaller; the issue leaves feasibility and implementation details open.

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

Descrizione

Working with island dispatch I had a bit of a brain wave. I'm not sure whether it's doable but I think it is?

Our pages site (github.com/napari/napari.github.io) is massive now, far above the 1GB soft-limit for gh-pages sites. This means that it could stop deploying at any moment. The main culprit is that every version contains a full duplicate of all our images and videos. We tried to do some deduplication but it caused more trouble than expected (I don't remember exactly but it was a mess) and that idea was abandoned.

But! Note that all the old versions don't keep getting updated: they just live statically at napari.org/<version-number>/. Also note that the way our gh-pages config works, any repo <repo-name> with gh-pages turned on gets served from napari.org/<repo-name>. So, we could rip out each old version of the built site and serve it from its own repo, just named github.com/napari/<version-number>? And we could even update our deploy script to do that automagically using gh cli and some permission tokens...?

CC @melissawm @Czaki

Lingua principale
Makefile
Stelle
13
Fork
71
Merge medio
3g 8h
PR unite (30g)
31

Preparare l'ambiente

  • Nessun Dockerfile né file Docker Compose
  • Ha un modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di napari/docs

Tutte le issue di napari/docs

Issue simili

Altre issue su DevOps

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.