tell me if this sucks
Documentation is Hard (new blog post)
i'm worried it's a bunch of hot takes but i'm actually really passionate about documentation and i care a bunch 😬 👍
@garbados I have thoughts about the fonts used on this website
@ccolocho tell me your thoughts. i didn't make the theme, just forked it.
in the css imo doesn't make text prettier.
@ccolocho i will look into changing these things. yay thanks!
@garbados buuuuuut this is a good piece and I agree with this hot take
@garbados not a content comment but a form comment: you justify your paragraphs in your css and all my UX/UI friends scream at me if I do that because it makes things less readable (on the web, it's good on paper) so I guess I should inform you about that
@bram i will look into changing it. i didn't make the theme, but i have forked it 👍
@garbados This doesn't suck at all. I liked it.
@garbados It sufficiently doesn't-suck that I saved the link for later reference, when any of my projects reaches the point of being worth other people wanting to deploy ^.^
You already know the answer: of course it does not suck.
I think you nailed the most important stuff. I liked especially the part about how your audience is varied end will (hopefully) be more and more diverse with your project growing. This point is often overlooked.
And thanks for you believing in us, it always helps. 😀
@garbados I think you've covered every issue I've struggled with in documentation I've needed to use, and several I haven't. And you've done it in a way that is as concise as possible, I think. Nice work! The only thing better would be if there were some way to make following your advice less overwhelming for my own projects. 😅
The social network of the future: No ads, no corporate surveillance, ethical design, and decentralization! Own your data with Mastodon!