mirror of
https://gitlab.com/simple-nixos-mailserver/nixos-mailserver.git
synced 2025-05-17 08:00:49 +05:00
47 lines
1.2 KiB
ReStructuredText
47 lines
1.2 KiB
ReStructuredText
Contribute or troubleshoot
|
|
==========================
|
|
|
|
To report an issue, please go to
|
|
`<https://gitlab.com/simple-nixos-mailserver/nixos-mailserver/-/issues>`_.
|
|
|
|
You can also chat with us on the Libera IRC channel ``#nixos-mailserver``.
|
|
|
|
Run NixOS tests
|
|
---------------
|
|
|
|
To run the test suite, you need to enable `Nix Flakes
|
|
<https://wiki.nixos.org/wiki/Flakes#Installing_flakes>`__.
|
|
|
|
You can then run the testsuite via
|
|
|
|
::
|
|
|
|
$ nix flake check -L
|
|
|
|
Since Nix doesn't garantee your machine have enough resources to run
|
|
all test VMs in parallel, some tests can fail. You would then haev to
|
|
run tests manually. For instance:
|
|
|
|
::
|
|
|
|
$ nix build .#hydraJobs.x86_64-linux.external-unstable -L
|
|
|
|
|
|
Contributing to the documentation
|
|
---------------------------------
|
|
|
|
The documentation is written in RST (except option documentation which is in CommonMark),
|
|
built with Sphinx and published by `Read the Docs <https://readthedocs.org/>`_.
|
|
|
|
For the syntax, see the `RST/Sphinx primer
|
|
<https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html>`_.
|
|
|
|
To build the documentation, you need to enable `Nix Flakes
|
|
<https://wiki.nixos.org/wiki/Flakes#Installing_flakes>`__.
|
|
|
|
|
|
::
|
|
|
|
$ nix build .#documentation
|
|
$ xdg-open result/index.html
|