1086
Discord != Documentation (lemmy.dbzer0.com)
(page 3) 43 comments
sorted by: hot top controversial new old
[-] Saigonauticon@voltage.vn 4 points 2 years ago

I'm usually on the documenting side of things. If something like this starts unfolding, I produce text or HTML files anyway, they go on github/lab/whatever, and I wash my hands of what happens next.

In the end I write documentation mostly for myself. When the company can't figure things out over Discord or whatever ephemeral chat interface they use, I get called anyway.

[-] Dirk@lemmy.ml 4 points 2 years ago

> I produce text or HTML files anyway

I do extensive in-code documentation. The compiler discards all comments so I don't worry about commenting my code. Source code is for humans to understand and write anyways.

[-] CallumWells@lemmy.ml 1 points 2 years ago

Also writing documentation in-code like JavaDoc or equivalents has always seemed great for me. Then you can have your toolchain generate the written documentation directly from that, and it can be updated easily based on what's actually documented in the code (but that does require that people keep that updated)

load more comments (2 replies)
[-] pineapplelover@lemm.ee 3 points 2 years ago

The only real alternatives to Discord is Matrix and Revolt. I am on both and there are a good number of people on there but they aren't too active. Wish they would be more popular and widely used

[-] ggiesen@lemmy.ca 1 points 2 years ago

No love for Mattermost?

load more comments (3 replies)
[-] ox0r@jlai.lu 3 points 2 years ago

Also, putting documentation in a format that has way too many features so just reading docs takes up 40% of CPU usage. Yes ,fuck you for using gitbook, i hate it so fucking much

[-] Gnubyte@lemdit.com 1 points 2 years ago

I don't think GitHub is social enough or the right tool to address bugs, talk about issues, or completely missing - ask for expertise. It's not even democratic enough and done in such a way that makes what to work on clear at times.

Some code is still more art than work or science but still there is a notion that maybe if there was a better tool than GitHub there would be no need for a discord.

load more comments
view more: ‹ prev next ›
this post was submitted on 28 Jul 2023
1086 points (100.0% liked)

Programmer Humor

38588 readers
179 users here now

Post funny things about programming here! (Or just rant about your favourite programming language.)

Rules:

founded 6 years ago
MODERATORS