Login
You're viewing the functional.cafe public feed.
  • Nov 6, 2026, 7:24 AM

    Okay, another:

    Focus on community. Foster online community.

    Create easily searchable references on the web. Not just documentation, but also forums and wikis. Make it so when somebody pastes an error message, they can immediately find a page where people are working through sorting that issue. Don't make them join your stupid Discord (you can't search the web for Discord messages!!)

    Actively encourage users to ask simple, easy questions, simply as a way of getting them used to asking questions. Ban the phrase RTFM ("Read the friendly manual", except we all know the F secretly doesn't actually stand for "friendly"). Don't dismiss users who "didn't do enough research before asking" -- many of them may not have known what to look up because they're so new to all of this. It's easy to be blinded by your own competence that you forget what it's like to be a newbie. That's not to mention how dreadful online search has become nowadays.

    I also suppose it goes without saying that you need to police and moderate your communities, and be explicitly welcoming to marginalized communities by being anti-racist, anti-transphobic, etc. This needs to be the No Bigots Club.

    💬 4🔄 20⭐ 57

Replies

  • 💬 0🔄 3⭐ 13
  • Nov 6, 2026, 8:05 AM

    @nacly I'd say there's probably a bit more nuance to be had in the Discord discussion (I'm sure the article being from 2021 contributes to that fact), but I vaguely agree with the post yeah.

    I'm not generally a proponent of what you might call "FOSS purity". If a tool is common and what people already use, I'm not super keen to abstain entirely solely because it's proprietary.

    But the issue is that even if Discord was FOSS, you can't look stuff up on Google (or whatever) from in those conversations. So it's not a good format for community support unless other options haven't really worked.

    We should be debugging in public so that many, many people can later refer to those pages to get help.

    💬 1🔄 0⭐ 7
  • Nov 6, 2026, 12:32 PM

    @riverpunk Agree that the un-"searchability" of #Discord is a major reason to avoid it.

    On the "purity" note, indeed the post I shared is 5 years old and would love to know if there's a newer version/equivalent of it for 2026. 😅

    I think we should still *aim* to use free (as in freedom) #opensource tools for our communities, which is often in tension with reaching people where they are! This can be tough to navigate and another reason to give each other empathy and understanding. ❤️

    💬 0🔄 2⭐ 2
  • Nov 7, 2026, 4:42 AM

    @riverpunk @nacly

    I’m not generally a proponent of what you might call “FOSS purity”. If a tool is common and what people already use, I’m not super keen to abstain entirely solely because it’s proprietary.

    My first reaction to your root post was “let’s start by calling it freedom-respecting software, or anti-monopolist software, instead of open source or FOSS”…and this is a good example of why that’s necessary. 🙂

    Once you realize that the movement is about user ownership and control and not any kind of purity or (as GNU calls it) “philosophy”…everything changes. Those who come to that realization avoid monopolistic (“closed source”, and centralized) software, because they become aware that it creates monopolies and gives others illegitimate power over them.

    Bugs can be fixed, features can be added, users can be onboarded, unpopular software can be made popular…but rarely does monopolistic software become anti-monopolistic.

    💬 2🔄 2⭐ 0
  • Nov 7, 2026, 9:40 AM

    @contrapunctus @nacly Might I suggest "Software for good"? Perhaps that could be a more useful phrase than Free Software or Open Source or FOSS or Libre or whatever.

    It may be harder to pervert Software For Good, at least compared to Free Software. And it would also maybe be a little more appealing (it may be more productive to say "we *are* this" instead of "we *oppose* that").

    But who knows, I only just thought of the phrase today...

    💬 1🔄 0⭐ 0
  • 💬 1🔄 0⭐ 0
  • 💬 1🔄 0⭐ 0
  • Nov 7, 2026, 10:01 AM

    @riverpunk
    It could, unless it's FOSS and not Big Tech that we "unionize", and make it possible to assign prices according to use-cases which we assess by our own values

    Use "it's bad for humanity" as a justification to charge more. Incentives that are less worse.

    @contrapunctus @nacly

    💬 0🔄 0⭐ 0
  • 💬 1🔄 0⭐ 0
  • 💬 2🔄 0⭐ 0
  • Nov 7, 2026, 6:43 PM

    @contrapunctus
    OTOH "community" risks sounding like a homogeneous group, sort or like a nation, which risks making us just guess or make up what the "community's best interests" are

    Something to hint that "communities" consist, among other parts, of "individual autonomies"? That's why I'm emphasizing "individuals, UGs, hackspaces, workshops, SMEs" and that we need them to have the capacity to walk away from any particular source of funding and survive mild shocks.

    @riverpunk @nacly

    💬 0🔄 0⭐ 0
  • 💬 0🔄 1⭐ 0
  • 💬 0🔄 0⭐ 0
  • Nov 6, 2026, 8:08 AM

    @riverpunk adding on to "create searchable references": make a page where you list all (intended) errors your application can throw, their cause, and potentially a fix

    im greatful for every documentation on how to configure or install a certain software, but if i get an error and nowhere's to be found what an error means im lost

    💬 1🔄 0⭐ 8
  • 💬 1🔄 0⭐ 5
  • Nov 6, 2026, 11:12 PM

    @riverpunk@defcon.social @kruemmelspalter@chaos.social

    fwiw Discord has made it so that you can search discord messages on a search engine if the server has opted into it. I still think this is a band-aid fix for a complicated problem, and that discord is currently speeding off a cliff wrt enshittification. What we need are some guides to hosting community infrastructure, like how to set up a simple to use and low cost forum. Ideally something low maintenance and not PHPBB.

    I see lots of orgs use Discourse, but they're kinda expensive. The free plan is pretty good, except they only let you have 2 admins, and the least expensive plan from there is $100/mo for 5 admins and a bunch of other features. I think that's kinda whatever bc maintaining your domain and email for you is nontrivial, but the fact that you need the $500/mo plan for SSO is highway robbery.

    💬 0🔄 0⭐ 0
  • Nov 6, 2026, 10:48 AM

    @riverpunk Here's a biggie: Open source projects run by democratic member-owned not-for-profits, with unionised staff who are paid a living wage.

    So you pay your $10 a month for, say, KDE or Mastodon or whatever, and you're a co-owner with voting rights.

    These open source non-profits, in turn, are institutional members of other non-profits, particularly those responsible for the frameworks and dependencies their software relies on.

    💬 1🔄 2⭐ 11
  • Nov 6, 2026, 11:09 AM

    @riverpunk Federated structures to these non-profits.

    You join the local, say, Mastodon branch in your city. They hold meetups at least once a month. All the local branches are members of a state branch, and then a national branch, and ultimately the international nonprofit.

    For online services, your local or state branch might offer members that service. In turn, the servers for those local and state branches are maintained by the national branch.

    💬 1🔄 2⭐ 5
  • Nov 6, 2026, 12:26 PM

    @riverpunk I know my answer is counterintuitive, but building face-to-face local community, democratic governance, and institutional structures around open source is important, IMHO.

    It creates an alternative economic and power structure to big corporate tech.

    The early days of home computing (at least in Australia) were driven by users' groups, swap meets, and home BBSes.

    If we want to take computing back, we need to rebuild and strengthen those grassroots structures.

    💬 0🔄 5⭐ 7
  • Nov 6, 2026, 1:16 PM

    @riverpunk I think this is important in many ways. Teaching each other and helping each other was a big part of the early tech community. It not only intellectually enriched us, it also built real human connections. It fostered a sense of belonging. It raised future contributors. When I first started doing development, such platforms were in decline and what was available to me was the ruthless StackOverflow. It gave me the exact opposite feeling.

    But it's even worse today, we are overwhelmed with slop. Search results were hijacked by SEO spam much before LLMs, and now it's spam on steroids with the help of the slop machines. Hand written blogs and teaching content are hard to find.

    On top of that, there is this looming feeling that the craft of programming is not valueable anymore, when people show me things I could have never built in a reasonable time, that they built with Claude in an evening, it makes me question if what I'm doing is worth it anymore.

    I think that communities will be the perfect antidote to everything that AI is doing to our craft. It can give learners slop-free resources. It can be a place to showcase things that AI could have never built. It can be a place where we forget all the madness that is happening outside, and just write programs, and find joy in it, with people who also find joy in it.

    💬 0🔄 0⭐ 0
  • Nov 8, 2026, 3:43 AM

    @riverpunk I know this is attached to a comment on community but since it mentioned wiki's. Make it easier to download and access wiki's and documentation offline. There are some such as arch I've gotten from kiwix but it would be nice if it was easier to have offline access of more knowledge resources without needing to scrape the internet (and contribute to making it worse)

    💬 0🔄 0⭐ 0