• 
      

    Rewrite the docs for creating site directories.

    Review Request #12846 — Created Feb. 25, 2023 and submitted — Latest diff uploaded

    Information

    Review Board
    release-5.0.x

    Reviewers

    This is a full rewrite of the documentation for creating sites. It
    provides far better coverage for all steps.

    The database setup now mentions MariaDB, recommends utf8mb4 for MySQL,
    and provides more concise installation steps for Postgres.

    A new section on SELinux was added, providing a full walkthrough on
    properly enabling SELinux policies for HTTP daemons and
    registering/applying the right permissions on site directories.

    Another new section on crontabs was added, providing setup steps and an
    example of the configuration file.

    The largest changes have to do with the web server configuration.

    We now provide a full guide on the following web servers:

    • Apache + mod_wsgi
    • Nginx + Gunicorn
    • Nginx + uWSGI

    Each of these go into the setup steps, point to the configuration files
    generated with Review Board 5.0.3+, and embeds sample configuration
    files.

    This should do a lot to help people get set up on a modern deployment,
    especially if they're aiming not to use Apache.

    Built the docs and read through them.

    Checked for bad links, spelling errors, and build errors.

    Tested the configurations locally with Apache, Nginx, Gunicorn, and
    uWSGI.

    Commits

    Files