This should give us at least a clean html, text, and man build
experience.

Closes #40036.

and move contributing from the root directory to the docs/ one,
since it links to testing but testing is not in the root directory.
This way when a user only reads the readme locally, does not try
to find testing in the root directory and instead will search for
more documentation in docs/.

and improve a bit the summary about what sbws does.
Closes: #29722

or Markdown. Also change links to be interpreted by GitHub and
remove Sphinx directives in the main documentation pages.

Closes #28648.

or from a local build or from the Debian package sbws-doc,
since the Sphinx directives are not ReST and therefore not
rendered in Github.

Since they don't exist anymore.

Closes #28662.

Since 1.0.0 is now reached.

Since it is not enabled by default from 1.0.0 version.

and it is linked from INSTALL

that will be considered production ready

it is usually found in CONTRIBUTING

and add a simple first sentence about what this program does.