• @d3Xt3r@lemmy.world
    link
    fedilink
    English
    2
    edit-2
    11 months ago

    I’m not opposed to it, but is there demand for it to be on GitHub?

    There is! These sort of guides are best suited to be hosted at Github/lab because of their dynamic nature. Any recommendations and “best practice” today might easily become outdated tomorrow in this fast-moving Linux world! Plus you can have contributors too submitting corrections and updates (if you wish to merge 'em), so you’re not left alone doing all the work.

    Here’s an example of one such guide I’ve used in the past that’s still being updated:

    https://github.com/AdelKS/LinuxGamingGuide

    • @Spectacle8011A
      link
      English
      111 months ago

      I think a dedicated wiki makes more sense for what is, essentially, documentation.

      • @d3Xt3r@lemmy.world
        link
        fedilink
        English
        111 months ago

        Yes, in theory. In practice, Github has become a hub for such living documents, especially in the Linux/OSS world, so it isn’t strange for people to look there for guides and recommendations.

        • @Spectacle8011A
          link
          English
          111 months ago

          As someone who recently worked on a Github wiki…it leaves much to be desired. The first being that I couldn’t actually push with git! I needed collaborator access for that. I also find Github’s markdown flavor to be limiting; you can do a lot more with a dedicated Wiki like MediaWiki. It was okay for viewing, though. And having the docs in an actual repository is much harder to navigate for users who aren’t developers.

          So while it’s something you see a lot, I think they would be easier to collaborate on and view on a dedicated wiki.