[Nix-dev] Missing documentation

[Ertugrul Söylemez]

>> Software should be fully documented.  If you don't know where the
>> line between "regular users" and "advanced users" is, don't draw one
>> in the first place.
>
> It's not so much a question of regular vs. advanced use, but whether
> something is a stable interface. If we document a command like
> nix-store --register-validity (which is mostly a hack to support the
> nixos-install bootstrap), we'd pretty much commit to supporting it in
> the future. If it's undocumented, we can change or remove it in the
> future.

Good point.  Nevertheless it's a useful feature, so perhaps it's time to
consider stabilising it or providing a stable wrapper.  At this point it
is practically the only way to install Nix-based distributions, and you
really want access to it when you're building lots of machines and
containers, i.e. whenever you don't want to use any of the predefined
installation routines.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 472 bytes
Desc: not available
Url : http://lists.science.uu.nl/pipermail/nix-dev/attachments/20150217/e9fceeca/attachment.bin