I really want the Mastodon documentation to have a good structure rather than just all information thrown together in a pile. I'm not sure how though.
@Gargron for the API stuff, I'd suggest documenting it in some machine-readable format and then generating the human-readable docs from that
@Gargron that would give you the added bonus of having the documentation double as a test suite for itself
@Gargron Have you reached out to anyone who knows content strategy? Seems to me like this is a great place to ask for help
though there's a Google issue that might be a show stopper https://github.com/rust-lang-nursery/mdBook/issues/847
@schlink I'm not asking for a tool. I said I don't know how to hierarchically structure the information
@gargron I'm a content strategist, my dude
@Mainebot Don't you have a full-time job though? This is probably a one-time large gig though since the software's functions don't change that often. If you want to go at it be my guest.
@gargron I have a v e r y. Full time job.
@gargron look if the gig pays, I can recommend someone.
@Gargron mastodon't make it a mess
@Gargron i'd be willing to take a stab at it, having just cleaned up a lot of docs for pixelfed. it's still incomplete but it's much less messy than it used to be. i would need to sit down and try to map it out with you first, though.
@trwnh Okay, let's do it. Paid, of course.
@Gargron add emojis
@Gargron Mastodon is better than Twitter you should make mastodon a single social network this would mean the end of Twitter and Square!
@peppone What do you mean by a single social network? Like, for singles?
@Gargron Thank you for the reply! Anyways What I mean is that the first time I knowed about mastodon I thought it was a social network like Facebook, Instagram and Twitter and not Open Source and decentralized. I know your goal is another but given the quality of the social network I thought you could make it to one server and not with other instance
i suggest you have a good look at the archwiki :) in my opinion and in many others they did a particularly good job that documenting .
now i don't suggest you copy and paste their scheme but it would be good inspiration i suspect.
do be the best got to learn from the best right.
@Gargron one word: PARAGRAPHS.
@Gargron I hate when that happens
@Gargron I'm a professional tech writer… New to Mastodon though, so, err, send me a PM or something?
@Gargron And I freelance and have experience with documenting distributed tech :)
The wiki formats of Wikipedia and the Arch Linux Wiki are excellent models of easily-accessible, well-organized information. An additional dictionary of special terms (e.g. "toot"...) would be welcome.
Hey there, I've dabbled in writing documentation for projects of varying technical-ness and I wanna say:
It's really unlikely another project's structure is going to be a perfect fit for you; the organization of the component sentences and paragraphs into their documents and such is one of the hardest parts of it for me and varies more by project than anything else.
tl;dr: there's no sure way to do it, and it's damn tricky to find even an acceptable way.
@Gargron yeah same
Server run by the main developers of the project It is not focused on any particular niche interest - everyone is welcome as long as you follow our code of conduct!