I think there should be only one link - to tests manual. In the tests manual chapters "writing test" and "running tests" should be flipped. So the order is like this:

• how to run tests
• list of tests (non-exhaustive, just to show what can be tested - simple test, simple test with GRUB/UEFI, graphical subsystem, SQL database, network of machines with frontend and backend, declarative containers)
• how to debug tests interactively
• and finally, how to write tests

@ardumont what do you think, would that order of sections be helpful? This reordering can be done in https://github.com/NixOS/nixpkgs/blob/master/nixos/doc/manual/development/nixos-tests.xml and https://github.com/NixOS/nixpkgs/blob/master/nixos/doc/manual/development/development.xml

I think there should be only one link - to tests manual.

I thought so as well but i was not so blunt as to propose the removal of the initial one.
Because there might have been reasons for it...

So do i adapt the commit to drop the first link?

In the tests manual chapters "writing test" and "running tests" should be flipped.

Possibly. I read the full chapter prior to act on it.
But indeed, as the writing tests chapter is quite long.
It could possibly inhibit users from reaching how to run tests.
Then again, there is a toc in the manual so i'm not sure if the flipping is that needed.

list of tests (non-exhaustive, just to show what can be tested - simple test, simple test with GRUB/UEFI, graphical subsystem, SQL database, network of machines with frontend and backend, declarative containers)

That's a good idea ;)

I thought so as well but i was not so blunt as to propose the removal of the initial one.

this section is for newcomers, so newcomer's opinion is valuable here!

So do i adapt the commit to drop the first link?

Yup. Manual has that link in the first line anyway

Thank you for your contributions.

This has been automatically marked as stale because it has had no activity for 180 days.

If this is still important to you, we ask that you leave a comment below. Your comment can be as simple as "still important to me". This lets people see that at least one person still cares about this. Someone will have to do this at most twice a year if there is no other activity.

Here are suggestions that might help resolve this more quickly:

1. Search for maintainers and people that previously touched the related code and @ mention them in a comment.
2. Ask on the NixOS Discourse.
3. Ask on the #nixos channel on irc.freenode.net.

I had forgotten about this, updated!

Cheers,

I marked this as stale due to inactivity. → More info

ping?

I marked this as stale due to inactivity. → More info

Thank your for your pr, a section similar to this Is now in the template

Great, thanks for the heads up.

Cheers,