getgauge/docs.gauge.org

Impressions about the docs for Node.js

Opened this issue · 2 comments

This is not an issue, but a suggestion. Nevertheless, I think it's important.
My impression is that the docs for installing gauge (https://docs.gauge.org/getting_started/installing-gauge.html?os=linux&language=javascript&ide=vscode) could feel daunting for some Node.js users, specially newbies. Maybe it will scare some people out of trying it.
Although the page looks cool and works well, I think that just the classic npm install -g @getgauge/cli yarn global add @getgauge/cli would be better as the main instruction. Just my two cents. Feel free to close this issue.

zabil commented

@appzillamonster that's a fair point.

When the docs were authored the npm installer was experimental. It's working well now and yes it makes sense to use npm for installing gauge as node is a pre-requisite.

Do you want to raise a PR for this? You can move the debian installer instruction to alternate methods.

Okay, cool. Will do. Give me a little time.