this post was submitted on 28 Jan 2024
2033 points (98.2% liked)

linuxmemes

21047 readers
1333 users here now

Hint: :q!


Sister communities:


Community rules (click to expand)

1. Follow the site-wide rules

2. Be civil
  • Understand the difference between a joke and an insult.
  • Do not harrass or attack members of the community for any reason.
  • Leave remarks of "peasantry" to the PCMR community. If you dislike an OS/service/application, attack the thing you dislike, not the individuals who use it. Some people may not have a choice.
  • Bigotry will not be tolerated.
  • These rules are somewhat loosened when the subject is a public figure. Still, do not attack their person or incite harrassment.
  • 3. Post Linux-related content
  • Including Unix and BSD.
  • Non-Linux content is acceptable as long as it makes a reference to Linux. For example, the poorly made mockery of sudo in Windows.
  • No porn. Even if you watch it on a Linux machine.
  • 4. No recent reposts
  • Everybody uses Arch btw, can't quit Vim, and wants to interject for a moment. You can stop now.

  • Please report posts and comments that break these rules!

    founded 1 year ago
    MODERATORS
     
    you are viewing a single comment's thread
    view the rest of the comments
    [–] [email protected] 8 points 8 months ago (5 children)

    This is often done by people while the project is unstable. No need to write documentation that gets outdated every few weeks, when you can help people live in discord.

    [–] [email protected] 54 points 8 months ago* (last edited 8 months ago)

    There is a gazillion options without having to use a login walled proprietary solution.

    [–] [email protected] 28 points 8 months ago* (last edited 8 months ago) (1 children)

    It shouldn't be done at all. If you're updating discord, you're writing something. That something should be, at the bare minimum, in a README file.

    If you can't be bothered with Markdown, just do text.

    I've never encountered this in the wild so I can't say for certain why a FOSS project would choose to do this.

    Maybe they are trying to get more people on their server?

    [–] [email protected] 4 points 8 months ago

    Discord uses a subset of Markdown for message formatting, so they'll be writing it regardless

    [–] [email protected] 10 points 8 months ago

    And when the project is stable, they don't care to document it, either.

    [–] [email protected] 5 points 8 months ago

    The first doc you write is the FAQ and let it handle the common requests -- no need to 'live' in discord. Locating that where more people can see it is normally obvious.

    [–] [email protected] 5 points 8 months ago

    Sounds like a project I don't want to use until it finishes baking.