• 21 Posts
  • 216 Comments
Joined 1 year ago
cake
Cake day: June 9th, 2023

help-circle




















  • If there is one belief that I’ve held for long is that we Free Software would be in a better situation than it is today if we simply dropped the whole idea “community”, “done by amateurs” and “volunteers in their spare time” and really start treating the whole thing as a professional industry. This whole xz crisis further exacerbated this belief.

    Almost everyone takes this work for granted and this is why is not properly valued. We should raise the bar at all levels: someone who wants to contribute in a project needs to show that they can deliver everything, maintainers should not accept “half-baked” proposals because “it is better than nothing”, developers should be more than comfortable sending a quote with a proper rate to someone that requests a feature.

    And if those people don’t want to do any of that, then let go see how much the commercial alternative would cost them.


  • We used Slack and we had a Confluence Wiki. No one bothered to keep Confluence up-to-date because everyone was just used to ask ad-hoc questions on Slack and get an answer by one of the respective team members. We “solved” this issue at one company with one reasonably simple policy: people were free to ask questions on Slack as much as they wanted, but the response should always have a link to the related Confluence page. You could even answer the question directly with a TL;DR, but the Confluence Page link should always be part of the answer.

    Every time that there was an Slack response without a link to Confluence, the responder’s team would get a mark, and every month the team with the most marks would have to bring something to the rest of the company. Basically, it forced everyone in the team to step up their documentation game, and it got everyone in the spirit of “collaborative editing”: sometimes, people would just write create a page with a very basic paragraph. Another team member would use that to extend the answer and so on. In just a few months, every department had a pretty solid documentation space and we even got used to start our questions with “I looked for X on Confluence and didn’t find anything. Can someone tell me where I can find info about it?”

    So, yes, you are right about the disconnect between “what experienced people want” and “what beginners want”, but even in this case it would make sense if most project managers used real-time chat platforms only for initial inquiries and triage, but used this inflow to produce long-term content in a structured document or wiki.