Daily Tildes discussion - suggestions for expansions/additions to Docs (and how you can help)

Deimos
Wed, 23 May 2018 19:22:50 +0000

Today I want to talk about expanding the information available on the Tildes Docs site. There's some info there, but there should be a lot more. Eventually, I'd like that site to include information about the site's goals, mechanics and so on, as well as things closer to standard "documentation", such as how the post formatting works, details on the tagging systems, etc.

One specific thing that I know I'd like to add before long is kind of a "FAQ for mechanics" that can have answers for the common questions that keep coming up, like "why is the comment box at the bottom instead of the top?".

To help with this, I've now open-sourced the files for both the Tildes Docs site and the Blog here now, so you can contribute to them directly if you'd like to: https://gitlab.com/tildes/tildes-static-sites/

@flaque has already written a page to help with Markdown formatting that I'll add soon (but I wanted to see if he'd like to do it as a proper merge request so he gets credit as a contributor). Anyone else is welcome to contribute to the Docs as well, and I'd appreciate the help. However, if you're not sure if it's something that I'd want to add it might be best to ask first before you start writing.

Outside of that, I'm open for suggestions about what you think would be good to include, or things that are already there that need work. Thanks!

Comments URL: https://tildes.net/~tildes.official/qf/daily_tildes_discussion_suggestions_for_expansions_additions_to_docs_and_how_you_can_help

Votes: 20

Comments: 12