keybase / keybase/keybase-issues

Bad instructions to install in Windows system

Open
#1,652 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
899
Forks
40
PR merge metrics
No merged PRs in 30d

Description

For people quite new at Githube and Node, the keybase install instructions are not working.

The prerequisites page is ok (GPG and Node.js check)

Installation page:
1- No instructions about where to run the instalation code
(npm install -g keybase-installer ; keybase-installer ; keybase version ;):
---- Run the commands inside Node.js terminal? DOS prompt terminal? Instructions only for a Linux shell terminal, and not for windows ? Doubt...

Installation process for Windows should be click-install. Windows's users are not familiar with command prompt terminal.

My 2 cents.
Cheers

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the installation page and compare its commands with the Windows installation process; the prerequisites page is reported as working. Clarify where Windows users should run the commands and document the intended installation flow, including whether a click-based installer is available. Done when a new Windows user can follow the page without guessing which terminal to use.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.