nushell.github.io icon indicating copy to clipboard operation
nushell.github.io copied to clipboard

Move Philosophy into Book

Open vwkd opened this issue 4 years ago • 1 comments

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.

vwkd avatar Oct 23 '21 16:10 vwkd

@vwkd That seems like a good idea. Feel free to submit a PR.

rgwood avatar Mar 07 '22 03:03 rgwood