89
RTFM (lemmus.org)
submitted 7 months ago by to c/linux@lemmy.ml
72 comments fedilink hide all child comments
 

Hello Linux community.

I'd like to take a moment to explain what I hope will be a simple concept (so really it's more of a reminder) that everyone should say least know and understand.

Not everyone (myself included) learns best by RTFM. Some of us need a guiding hand or to watch a video instead. It's not that we're lazy or don't like reading, it's just that it doesn't work efficiently enough.

you are viewing a single comment's thread
view the rest of the comments
[–] 3 points 7 months ago* (3 children)

I am talking from experience here. Some of the documentation is out of date, some is meant for Channel NixOS installs and not so appropriate for Flake-based installs.

Most of the fixes for my issues I find across NixOS discourse forum posts, or in the subreddit of the other platform. The Wiki/official documentation is not enough.

I’m glad you switched to NixOS (welcome!) but this is gap in documentation is something that will become more apparent over time. The NixOS official wiki ironically often links to Arch wiki to explain certain concepts further.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 3 child comments
    •
  • [–] 2 points 7 months ago (2 children)

    What am I missing? There should be no difference from "normal" to flake installs on anything NixOS related, only in syntax of the language itself since you're wrapping things. I've gone flakes and now somewhat dendritic and haven't had to check NixOS docs for anything (only nix language docs and other people's configs to see how they solved certain language specific peculiarities)

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •
  • [–] 1 point 7 months ago* (1 child)

    Uh… is the NixOS documentation “one of the best around” or have you never checked it? It really can’t be both.

    Understand, I’m not trying to criticize NixOS. I use NixOS exclusively and it’s my daily driver. But the documentation really isn’t all there, and it’s not centralized. The best solutions you find across forums, blog posts, random wikis, and by checking other people’s configs like you said.

    But yes, the fact you can test things without fear of breaking your system allows you to make hundreds of mistakes stress-free. That’s one of the best features about NixOS.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 1 child comment
    •
  • [–] 1 point 7 months ago

    I've checked the NixOS documentation extensively for setting things up, my point was that I hadn't had to do so for migrating to flakes, as that's not a NixOS thing, but rather a Nix language thing.

  • permalink
  • fedilink
  • source
  • parent