That devs in FOSS projects are 1st-class citizens and doc writers are 2nd/3rd has been so pervasive for so long, that I *still* I dismiss my almost 20yrs of writing and only treat my relatively small code as my "real" contribution. Glad to see some communities trying to fix this.

@kyle agreed, what are some communities you have seen that are doing a good job addressing it?

@edsu I don't have specific names in mind (except maybe Jordan Sissel), but what I'm mostly seeing is pockets of discussion within a number of communities, especially when they see someone who submits docs undervalue their own work when they submit it. Other contributors correct that and emphasize the value of docs.

@kyle yes that's a good practice to encourage, thank you for sharing that. I guess including documentation work in change logs could help too. A small thing but taken in aggregate I think it could be helpful.

Sign in to participate in the conversation
Librem Social

Librem Social is an opt-in public network. Messages are shared under Creative Commons BY-SA 4.0 license terms. Policy.

Stay safe. Please abide by our code of conduct.

(Source code)

image/svg+xml Librem Chat image/svg+xml