Talk:K3s

Move nixpkgs documentation to the wiki

@Superherointj: Instead of deleting the content from the wiki and referring to nixpkgs, how about we do the reverse and move the content here, with a link from the repo README? The wiki is better for discoverability, especially via search engines. Also, IMO the wiki is where all user documentation should eventually reside together in a central place. Sdht0 (talk) 15:42, 6 June 2024 (UTC)

Currently the single source of truth for K3s docs is at nixpkgs. It was agreed by K3s maintainers:

https://github.com/NixOS/nixpkgs/issues/313252

https://github.com/NixOS/nixpkgs/pull/314395

It's preferable to point to current information over keeping stale information. Currently it is not planned to duplicate information. But effort has been put into improving K3s docs at nixpkgs.

Users can still contribute to Wiki, to be eventually integrated to K3s docs at nixpkgs. Or to contribute directly to K3s docs at Nixpkgs, if they feel the need. Superherointj (talk) 19:49, 6 June 2024 (UTC)

As far as I am aware, no other packages/services put documentation directly into nixpkgs outside of nixos/doc/manual.

It would be more consistent to put the service information into https://nixos.org/manual/nixos/stable/ and the additional configuration back into the wiki. Pigs (talk) 06:04, 30 April 2025 (UTC)

In the linked PR and issue I couldn't find any explanation why the documentation is not in the manual. Maybe the size of the manual page was a concern? (Which would be alleviated when we manage to switch to a multi-page build: https://github.com/NixOS/nixpkgs/issues/156309) FliegendeWurst (talk) 07:11, 30 April 2025 (UTC)