Ask Lemmy
A Fediverse community for open-ended, thought provoking questions
Rules: (interactive)
1) Be nice and; have fun
Doxxing, trolling, sealioning, racism, and toxicity are not welcomed in AskLemmy. Remember what your mother said: if you can't say something nice, don't say anything at all. In addition, the site-wide Lemmy.world terms of service also apply here. Please familiarize yourself with them
2) All posts must end with a '?'
This is sort of like Jeopardy. Please phrase all post titles in the form of a proper question ending with ?
3) No spam
Please do not flood the community with nonsense. Actual suspected spammers will be banned on site. No astroturfing.
4) NSFW is okay, within reason
Just remember to tag posts with either a content warning or a [NSFW] tag. Overtly sexual posts are not allowed, please direct them to either !asklemmyafterdark@lemmy.world or !asklemmynsfw@lemmynsfw.com.
NSFW comments should be restricted to posts tagged [NSFW].
5) This is not a support community.
It is not a place for 'how do I?', type questions.
If you have any questions regarding the site itself or would like to report a community, please direct them to Lemmy.world Support or email info@lemmy.world. For other questions check our partnered communities list, or use the search function.
6) No US Politics.
Please don't post about current US Politics. If you need to do this, try !politicaldiscussion@lemmy.world or !askusa@discuss.online
Reminder: The terms of service apply here too.
Partnered Communities:
Logo design credit goes to: tubbadu
view the rest of the comments
I've spent some 5 hours just today documenting and writing instructions on some IT tools for my collective. One person said its cool though, so not bad.
The ability to write clear documentation is an invaluable skill. So many open source projects have terrible docs. The docs are probably written by the devs themselves, who perhaps don't realize that end users won't have the intimate knowledge of the thing they're documenting as they do, so they leave a lot unsaid that should really be explicit.
In IT, at least in networking, systems quickly become black boxes even to the person that designed it, and good docs are just as useful to the person writing them.
You sir are a champion. So few of us do documentation and wonder why we have to fix the same problems over and over.
You deserve a smooch 😘
unsolicited comradery
Hey, u wanna share some means of reproduction?