When I said the documentation lacks a structure, this is what I meant... This isn't even all files in the "running mastodon" folder. How is anyone supposed to know where to start, what they need to read? I need to rework this into some kind of 1-2-3 story.
Conversation
Notices
-
Eugen (gargron@mastodon.social)'s status on Sunday, 23-Sep-2018 05:18:52 JST
Eugen
-
Eugen (gargron@mastodon.social)'s status on Sunday, 23-Sep-2018 05:26:32 JST
Eugen
@buggerbee https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Production-guide.md
-
Eugen (gargron@mastodon.social)'s status on Sunday, 23-Sep-2018 07:20:36 JST
Eugen
How about:
1. Installation
2. Configuration
3. Post-installation steps
4. Scaling up
5. Optional featuresThe old docs will still be on GitHub, so don't worry about that - I want to write new ones for the site. So how's this for structure?
In conversation permalink Maya Minatsuki :neko_smiley: repeated this. -
Eugen (gargron@mastodon.social)'s status on Sunday, 23-Sep-2018 08:06:17 JST
Eugen
Documentation site online with rough stubs for content. Didn't check how it looks on mobile yet
In conversation permalink Maya Minatsuki :neko_smiley: repeated this. -
Eugen (gargron@mastodon.social)'s status on Sunday, 23-Sep-2018 09:36:55 JST
Eugen
Wrote this page!
In conversation permalink -
Eugen (gargron@mastodon.social)'s status on Sunday, 23-Sep-2018 09:37:08 JST
Eugen
Wrote this page!
In conversation permalink -
Eugen (gargron@mastodon.social)'s status on Sunday, 23-Sep-2018 09:40:47 JST
Eugen
@kavbojka my patreon page does
In conversation permalink -
Eugen (gargron@mastodon.social)'s status on Monday, 24-Sep-2018 06:54:47 JST
Eugen
Wrote this page! Describing possible moderation actions and spam-fighting methods...
In conversation permalink -
Eugen (gargron@mastodon.social)'s status on Monday, 24-Sep-2018 08:00:13 JST
Eugen
@npd Mods are users. "Administrator guide" = "Sysadmin guide"
In conversation permalink -
Eugen (gargron@mastodon.social)'s status on Monday, 24-Sep-2018 09:59:15 JST
Eugen
Wrote this page! Installation instructions, modeled after the ones @staticsafe wrote before:
https://docs.joinmastodon.org/administration/installation/
The ending bits are a bit of a lie for now, Mastodon does not include a `dist` directory with templates for the nginx config and systemd services, but I think it should, and I am planning to add that.
In conversation permalink よぅ :c_anlucea: :e_angel: repeated this. -
Eugen (gargron@mastodon.social)'s status on Monday, 24-Sep-2018 10:46:07 JST
Eugen
@sluglife I've never used ufw
In conversation permalink -
Eugen (gargron@mastodon.social)'s status on Tuesday, 25-Sep-2018 00:31:42 JST
Eugen
Wrote this page! API permissions:
In conversation permalink ? Himawari Prodromou and Maya Minatsuki :neko_smiley: repeated this. -
Eugen (gargron@mastodon.social)'s status on Tuesday, 25-Sep-2018 08:05:31 JST
Eugen
Okay, this took a whole day but I mapped out all entities in the Mastodon API along with in which version a particular attribute was added:
In conversation permalink -
Eugen (gargron@mastodon.social)'s status on Wednesday, 26-Sep-2018 04:44:18 JST
Eugen
Wrote this page:
User Guide: Decentralization
https://docs.joinmastodon.org/usage/decentralization/
Is there something you think is still missing from that page?
In conversation permalink 北枕 in Pawoo repeated this. -
Eugen (gargron@mastodon.social)'s status on Wednesday, 26-Sep-2018 04:45:49 JST
Eugen
@cambrian_era Whoever is curious enough to click on that in the menu I guess? I don't know.
In conversation permalink -
Eugen (gargron@mastodon.social)'s status on Wednesday, 26-Sep-2018 06:03:31 JST
Eugen
Wrote this page:
User Guide: Basics
https://docs.joinmastodon.org/usage/basics/
Yay! All pages in the User Guide section have content now.
In conversation permalink -
Eugen (gargron@mastodon.social)'s status on Wednesday, 26-Sep-2018 07:52:09 JST
Eugen
Okay, I remembered to add this page: Upgrading Mastodon to a newer release
In conversation permalink
-