Dvc.org: contributing docs are not actionable enough

[Suor]

Development environment does not contain exact instruction on how to set it up, e.g.:

git clone [email protected]:<username>/dvc.org.git
cd dvc.org

# The next two lines are only obvious to someone who used node before
npm install
npm install -g yarn  # Instead of going to yarn website as we say now
yarn dev 

Also it is far from obvious that git pre-commit hook is installed inside npm install, unless you look at its output closely.

[shcheklein]

Have simplified and changed the doc a little bit, @Suor PTAL. I'm not sure why do we need npm install before installing yarn?

[jorgeorpinel]

Hmmm, now it reads

Make sure you have the latest version of Node.js and Yarn are installed:

It's the right intention but that sentence is wrong. I'll remove "are" in my regular doc updates PR. Otherwise seems complete now. git clone and cd, install Node and Yarn, and run yarn and yarn dev. But I will separate the last 2 commands as they do different things.

[Suor]

What's the point making people read ads about yarn instead of simply providing them with a command npm install -g yarn?

[shcheklein]

@Suor it's already here, right - https://dvc.org/doc/user-guide/contributing/docs :)

[shcheklein]

@Suor my question was about npm install itself (comes before npm install -g yarn in your description)

[Suor]

Oh, I see. Much better now)

[Suor]

This might be closed unless you guys have something more in mind.

[Suor]

@shcheklein I used npm install because this is what you usually do with a Node.js project. yarn replaces that, but I forgot about that.

[shcheklein]

so, closing this as it fixed and even improved by @jorgeorpinel it the most recent WIP regular updates PR