Move Philosophy into Book

オープン

#211 2021年10月23日に作成コメント 1 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 2/5
見積もり時間: 1〜3時間
初心者へのやさしさ: 45/100

issue の種類: ドキュメント
明瞭さ: 明確に書かれている
活発さ: 停滞
領域: documentation

調査の方向性

Contributor Book の Philosophy セクションを、メインブックの構成、特に Installation セクションと Usage セクションと比較する。メインブック内で Philosophy を Installation の後、具体的な Usage セクションの前に移動する。Why が How より前に提示され、Contributor Book での以前の配置が処理されれば完了。

索引モデルが issue の本文から書いたものです。

説明

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.

主要言語: TypeScript
スター: 258
フォーク: 561
平均マージ: 3時間 20分
マージ済み PR（30日）: 15

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

nushell/nushell.github.io のほかの issue

`--log-level` isn't documented in documentation for flags オープン

難易度 1/5 1〜3時間初心者へのやさしさ 68/100

nushell/nushell.github.io#2081 · コメント 3 件 · 2025年11月25日に作成
[ja] fix statement about lines output type オープン

難易度 1/5 1時間未満初心者へのやさしさ 62/100

nushell/nushell.github.io#767 · コメント 1 件 · 2023年2月4日に作成
The cookbook example "Accessing HTTP Response Metadata While Streaming" doesn't stream オープン

難易度 3/5 1〜2日初心者へのやさしさ 58/100

nushell/nushell.github.io#2232 · コメント 1 件 · 2026年8月24日に作成
Color scheme toolbar button does not apply to code samples オープン

難易度 3/5 1〜2日初心者へのやさしさ 58/100

nushell/nushell.github.io#2209 · 2026年7月19日に作成
Pages won't load after a period of time オープン

難易度 4/5 3〜5日初心者へのやさしさ 45/100

nushell/nushell.github.io#2194 · 2026年7月5日に作成

nushell/nushell.github.io の issue をすべて見る

似ている issue

[MagmaFusion] rapports qualité - contenus des rubriques en anglais manquants オープン

難易度 2/5 1〜3時間初心者へのやさしさ 65/100

InseeFr/Bauhaus#1634 · 2026年9月23日に作成
[Bug]: SSH host picker duplicates configured aliases and known_hosts targets オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

pingdotgg/t3code#13270 · 2026年9月23日に作成
resetSseResponseWait and noteRequestProgress silently fail to re-arm the 60s relay timeout if progress tokens arrive as strings オープン

bug v2

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

modelcontextprotocol/inspector#2458 · コメント 1 件 · 2026年9月23日に作成
Resources: Update work of changsha オープン

難易度 1/5 1時間未満初心者へのやさしさ 75/100

railmapgen/rmp-gallery#4068 · 2026年9月23日に作成
sass-1.105.0.tgz: 1 vulnerabilities (highest severity is: 7.5) オープン

Mend: dependency security vulnerability status: needs triage 🕵️‍♀️

難易度 2/5 1〜3時間初心者へのやさしさ 70/100

carbon-design-system/ibm-products#9907 · 2026年9月23日に作成

TypeScript の issue をもっと見る