Move Philosophy into Book
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Accessibilité débutants
- 45/100
- Type d'issue
- Documentation
- Clarté
- Clairement spécifiée
- Activité
- À l'abandon
- Domaine
- documentation
Piste de recherche
Comparer la section Philosophy du Contributor Book avec la structure du livre principal, en particulier les sections Installation et Usage. Déplacer Philosophy dans le livre principal après Installation et avant les sections Usage concrètes ; terminé lorsque le Why est présenté avant le How et que l’ancien emplacement dans le Contributor Book est traité.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
The book does a great job on the How. It explains well how Nushell works. But it lacks a bit on the Why. The Introduction hints on it but it seems to get lost on the surface, e.g. "modern style of development", "modern feel", "UX polish". New users tend to want to know the Why first before the How.
The Philosophy section of the Contributor Book does a great job on the Why. But it's usually read only long after the How and only by people interested in the underlying details.
I'd like to propose moving the Why before the How. This means moving the Philosophy section into the main book before any concrete "Usage" sections. It would probably make sense to put it just after the Installation section.
- Langage dominant
- TypeScript
- Étoiles
- 261
- Forks
- 561
- Merge moyen
- 4 h 36 min
- PR mergées (30 j)
- 16
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de nushell/nushell.github.io
-
Difficulté 1/5 1-3 heures Accessibilité débutants 68/100
nushell/nushell.github.io#2081 · 3 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 62/100
nushell/nushell.github.io#767 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 3/5 1-2 jours Accessibilité débutants 58/100
nushell/nushell.github.io#2232 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 3/5 1-2 jours Accessibilité débutants 58/100
nushell/nushell.github.io#2209 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 4/5 3-5 jours Accessibilité débutants 45/100
nushell/nushell.github.io#2194 ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de nushell/nushell.github.io
Issues similaires
-
Table: Space fires onActivate in single-selection mode — the reference doc and the JSDoc disagreeOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
sidorares/react-x11-components#764 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
backnotprop/plannotator#1840 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
JoviDeCroock/pracht#432 ·
Les mainteneurs répondent en général sous 1 jour
-
Add: CNN en Espanol SDOuverteapproved check:passed streams:add
Difficulté 1/5 Moins d'une heure Accessibilité débutants 75/100
Les mainteneurs répondent en général sous 1 jour
-
Hardware attribute name "app Connection Support" has inconsistent casingPeut-être pris Une pull request liée à cette issue est ouverte ou déjà fusionnée. Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
walletbeat/walletbeat#1628 ·
Les mainteneurs répondent en général sous 1 jour