Skip to content

remove _class mentions` from option results' snippets#1346

Open
KiaraGrouwstra wants to merge 1 commit into
NixOS:mainfrom
KiaraGrouwstra:declass
Open

remove _class mentions` from option results' snippets#1346
KiaraGrouwstra wants to merge 1 commit into
NixOS:mainfrom
KiaraGrouwstra:declass

Conversation

@KiaraGrouwstra

Copy link
Copy Markdown
Collaborator

Closes #1344.

@KiaraGrouwstra KiaraGrouwstra changed the title unlist _class mentions` from option results' snippets remove _class mentions` from option results' snippets Jun 18, 2026
@KiaraGrouwstra

Copy link
Copy Markdown
Collaborator Author

arguably these were more correct than the suggested file names mentioned (configuration.nix is now contending for NixOS entrypoint with both system.nix as well as with flakes), but yeah, unfortunately _class may have been mostly confusing to newer users. perhaps we could find a better place for them some time.

@Eveeifyeve

Eveeifyeve commented Jun 25, 2026

Copy link
Copy Markdown
Member

It would be good to make the modular services changed to state the nixos example, so that it's more explicit the example is for nixos. Like adding # configuration.nix to the top of the file could do it. With home-manager, darwin, etc people can find out with their respective docs or options defined.

@KiaraGrouwstra

KiaraGrouwstra commented Jun 25, 2026

Copy link
Copy Markdown
Collaborator Author

so that it's more explicit the example is for nixos

hm. so.
is that technically correct right now tho?
cuz you would get the generic functionality (which is worth whatever your system shims do with that), while currently at least one service (php-fpm) out of the like 4 seems to have finix bits there as well.

now, the existing services there may have some escape hatches for nixos, but at that point we've maybe reached a semantic discussion there.

the underlying semantic question right now then becomes: is a modular service something that works on your system, or is it a service implementing the generic interface, rendering 'it works on system x' technically outside of the responsibility of what a modular service is, at least until the interface (and the system's shims, without requiring the escape hatches) make it work?

i think the proper solution there would be explicitly segregating the generic bits vs the system-specific escape hatches so one would know what they'd get, but that isn't where we're at today.

Signed-off-by: cinereal <cinereal@riseup.net>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

_class incorrectly shown in option usage example

2 participants