Structure of various docs / website

[andythenorth]

Current

Website

• Home
  • download
  • learn how to play > wiki
  • visit our community > tt-forums
  • sidebar screenshots
• About
  • overview + license
  • feature list
  • supported platforms
• Manual > wiki
• Screenshots
• Servers
• Development
  • translating > web translator
  • reporting bugs
  • obtaining the source code
    • source > github
    • source documentation > delegates to Doxygen https://docs.openttd.org/
  • compiling
    • deps list
    • instructions > delegates to wiki, not COMPILING.md
  • development of newgrf
    • delegates to wiki, devzone, forums etc
  • development of AI and GS
• Forum > tt-forums
• Community > https://wiki.openttd.org/Community
• Contact
  • email addresses
  • irc
  • mirrors
• Donate

README.md

• Get Started
• Supported Platforms
• Contact / Community
• Contribute
• Translating
• License
• Credits

CONTRIBUTING.md

• [quite a few useful things]

COMPILING.md

• outline per platform
• deps list
• supported compilers
• compiling base sets

docs

• admin_network.md
• debugging_desyncs.md
• desync.md
• HOWTO_compile_lang_files.md
• linkgraph.md
• multiplayer.md
• landscape html files
• ob format txt files
• png and svg files
• palettes

[andythenorth]

What follows is not a detailed list of pages, but a list of which information a location is canonical for.

Website

Pages for

• download
• screenshots
• servers
• contact / community
• donate
• contribute / develop??

Signposts to

• translations
• wiki manual

Missing pages?

• get started?
• add-on content?
• multiplayer guide?

README.md (GitHub)

• Get Started
• Supported Platforms
• Contact / Community
• Contribute
• Translating
• License
• Credits

COMPILING.md

• Basic compile information per supported platform.
• Additional compile help / late-breaking info in wiki pages

Should this be moved to /docs?

CONTRIBUTING.md

• ?? stuff ??

/docs (Github)

Technical information for developing / debugging OpenTTD

Web Translator (front page of eints)

• instructions for translating using web translator

Homeless stuff, square pegs in round holes

• multiplayer.md from /docs
• goals of the official branch: https://wiki.openttd.org/FAQ_development#What_are_the_goals_of_the_offical_branch.3F
• meta: this list of what is found where should have a home

Wiki

Everything else.