OpenTTD / OpenTTD/OpenTTD

[Bug]: No documentation for new network public key feature

Open
#14,875 1 comment 5 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C++
Stars
8.3k
Forks
1.3k
Avg merge
1d 20h
Merged PRs (30d)
37

Description

Version of OpenTTD

15.0-pre

Expected result

Nice comprehensive documentation about how to securely set up a server that only allows certain people in.

Actual result

Network passwords were removed in https://github.com/OpenTTD/OpenTTD/pull/12323 & https://github.com/OpenTTD/OpenTTD/pull/12300 et al., and people are going to become confused. We need some documentation that we can point at that explains the new methods (and possibly even why they're better)

Steps to reproduce
  1. Host a server in old versions
  2. Upgrading hosting to 15.0
  3. Become confused
  4. Post issue on bug tracker
  5. Get flamed

Contributor guide

Open the contributing guide

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

Read the network-password removal changes in PRs 12323 and 12300, then locate the existing server setup and networking documentation. Document the new public-key-based methods, secure access setup, and why the old password approach changed; done means users upgrading to 15.0 can follow the guidance to restrict server access.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
documentation, networking, security
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.