SagerNet / SagerNet/sing-box

Write a man page for end users

Open
#3,178 1 comment 9 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Go
Stars
38.2k
Forks
4.6k
Avg merge
19d 15h
Merged PRs (30d)
1

Description

Currently the official documentation is ambiguous for novice users who only want to use the command line client to connect to their VPN servers and don't care about the technical aspects of json files or whatnot.

I suggest the creation of a manpage consisting a simple tutorial for configuring and connecting to proxy servers using the terminal. It should have explanations for importing config links and usage of Sing-Box subcommands and flags.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the existing official documentation and the command-line client's help output first. Define a man-page tutorial for configuring and connecting to proxy or VPN servers, importing config links, and using Sing-Box subcommands and flags. Done means novice users can follow the terminal steps without needing the technical JSON details.

Written by the indexing model from the issue text.

Assessment

Domain
cli, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.