nushell / nushell/nushell.github.io

a refactoring idea to rewrite the `README`

Aperta
#814 2 commenti 3 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Lingua principale
TypeScript
Stelle
258
Fork
561
Merge medio
3h 20m
PR unite (30g)
15

Descrizione

hello there πŸ‘‹ πŸ˜‹

i feel this website repository is mainly made for developers or people who click on the "Edit this page on GitHub" button in the footer.

the other day i was looking for contribution guidelines and ended up asking how to run the website locally on the discord...
i did not see the CONTRIBUTING.md file in the root of the repo 😭

in fact, i looked at the main README, looking for instructions but found none => this is because the main ./README.md file IS the
english frontpage of www.nushell.sh!

my idea

i propose to move the frontpage of the website to some other place than ./README.md and write a true development-oriented README.md
to:

  • point to the website itself at www.nushell.sh
  • point to the main nushell repo
  • explain in details how to contribute to this repo OR at least explicitely point to CONTRIBUTING.md

some details

  • i think the paths to all the pages MD files are specified in .vuepress/configs/, right?
  • i propose to move blog/, book/, commands/, contributor-book/ and cookbook/ to a new en/ directory, leading to the following architecture:
.
β”œβ”€β”€ CNAME
β”œβ”€β”€ CONTRIBUTING.md
β”œβ”€β”€ i18n-meta.json
β”œβ”€β”€ i18n.nu
β”œβ”€β”€ LICENSE
β”œβ”€β”€ make_docs.nu
β”œβ”€β”€ package.json
β”œβ”€β”€ package-lock.json
β”œβ”€β”€ README.md
β”œβ”€β”€ assets/
β”œβ”€β”€ de/
β”œβ”€β”€ es/
β”œβ”€β”€ en/
β”œβ”€β”€ ja/
β”œβ”€β”€ pt-BR/
β”œβ”€β”€ snippets/
β”œβ”€β”€ tr/
└── zh-CN/

and one more level details

.
β”œβ”€β”€ CNAME
β”œβ”€β”€ CONTRIBUTING.md
β”œβ”€β”€ i18n-meta.json
β”œβ”€β”€ i18n.nu
β”œβ”€β”€ LICENSE
β”œβ”€β”€ make_docs.nu
β”œβ”€β”€ package.json
β”œβ”€β”€ package-lock.json
β”œβ”€β”€ README.md
β”œβ”€β”€ assets
β”‚   └── images
β”œβ”€β”€ de
β”‚   β”œβ”€β”€ README.md
β”‚   └── book
β”œβ”€β”€ es
β”‚   β”œβ”€β”€ README.md
β”‚   β”œβ”€β”€ book
β”‚   └── contributor-book
β”œβ”€β”€ en
β”‚   β”œβ”€β”€ blog
β”‚   β”œβ”€β”€ book
β”‚   β”œβ”€β”€ commands
β”‚   β”œβ”€β”€ contributor-book
β”‚   └── cookbook
β”œβ”€β”€ ja
β”‚   β”œβ”€β”€ README.md
β”‚   └── book
β”œβ”€β”€ pt-BR
β”‚   β”œβ”€β”€ README.md
β”‚   β”œβ”€β”€ book
β”‚   └── contributor-book
β”œβ”€β”€ snippets
β”‚   β”œβ”€β”€ installation
β”‚   β”œβ”€β”€ introduction
β”‚   └── moving_around
β”œβ”€β”€ tr
β”‚   β”œβ”€β”€ README.md
β”‚   └── book
└── zh-CN
    β”œβ”€β”€ README.md
    └── book

that way

  • the english default channel would be just another language channel, even though the prefered one by default
  • the repo would have a more homogenous structure
  • we would be able to move the english frontpage from README.md to en/README.md, as with the other languages
  • we would be able to write a true README for the website repo

i wanted to have some feedback before trying to refactor the website like this.
shouldn't be that much work, mainly changing paths, but ehe πŸ˜‰

Guida per i contributori

Apri la 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.

Direzione di ricerca

Inizia da README.md, CONTRIBUTING.md e dalle definizioni dei percorsi in .vuepress/configs/. Esamina come vengono referenziati blog/, book/, commands/, contributor-book/, cookbook/ e le directory delle lingue prima di proporre lo spostamento. Il lavoro Γ¨ completato quando il repository dispone di un README orientato allo sviluppo, il contenuto in inglese si trova sotto en/ e tutti i percorsi documentati rimangono coerenti.

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

Valutazione

Stack tecnologico
markdown
Ambito
documentation, internationalization
Tipo di issue
Refactoring
DifficoltΓ 
4/5
Tempo stimato
3-5 giorni
Stato di attivitΓ 
Ferma
Chiarezza
Abbastanza chiara
IdoneitΓ  per principianti
32/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.