nushell / nushell/nushell.github.io
a refactoring idea to rewrite the `README`
Dieses Issue hat noch niemand ΓΌbernommen.
- Vorherrschende Sprache
- TypeScript
- Sterne
- 258
- Forks
- 561
- Γ Merge
- 3 Std. 20 Min.
- Gemergte PRs (30 T.)
- 15
Beschreibung
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
nushellrepo - 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
MDfiles are specified in.vuepress/configs/, right? - i propose to move
blog/,book/,commands/,contributor-book/andcookbook/to a newen/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.mdtoen/README.md, as with the other languages - we would be able to write a true
READMEfor 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 π
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es ΓΌbernimmst β das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Γffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit README.md, CONTRIBUTING.md und den Pfaddefinitionen in .vuepress/configs/. PrΓΌfe, wie blog/, book/, commands/, contributor-book/, cookbook/ und die Sprachverzeichnisse referenziert werden, bevor du den Umzug vorschlΓ€gst. Als abgeschlossen gilt die Aufgabe, wenn das Repository ΓΌber eine entwicklungsorientierte README verfΓΌgt, der englische Inhalt unter en/ liegt und alle dokumentierten Pfade konsistent bleiben.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- markdown
- Bereich
- documentation, internationalization
- Issue-Typ
- Refactoring
- Schwierigkeit
- 4/5
- GeschΓ€tzter Aufwand
- 3-5 Tage
- AktivitΓ€tsstatus
- Veraltet
- Klarheit
- GrΓΆΓtenteils klar
- AnfΓ€ngerfreundlichkeit
- 32/100