The Clarifications section should probably be removed because (each number point is a reason to remove the corresponding number point in that section):
- The user setting up Gitea would probably be familiar with what Gitea is, so there's no need to explain the history of Gitea
- This should either be removed or directly link to the Gitea documentation for setting up in a Docker container
- Just remove this
- (a) the git command doesn't need to be installed separately (it's a dependency of Gitea), (b) While the knowledge that server repositories are bare repositories can be important, I don't think it's critical in the setting up of Gitea.
The Pre Requirements section isn't needed, and should be replaced with instructions on how to set up the databases (for example with mariadb):
apk add mariadb mariadb-client mysql_install_db --user=mysql --datadir=/var/lib/mysql service mariadb start rc-update add mariadb mysql_secure_installation mysql -u root -p CREATE DATABASE gitea; GRANT ALL ON gitea.* TO 'giteadbuser'@'localhost' IDENTIFIED BY 'giteadbpasswd'; FLUSH PRIVILEGES; EXIT
As for the hostname configuration in the Pre Requirements section, if a user hasn't yet run setup-hostname, they will be having a bigger problem than not just being able to get Gitea working.
The hacky 'Install most dependencies from community' then 'Switch to edge to install Gitea' and finally 'Switch back to community' instructions in the Installation section can be removed given that Gitea has been in stable community since v3.6. The warning about manually creating a user can also be removed since the pre-install script handles that.
The Database configurations section can be removed since the info will be expanded on higher up (replacing the Pre requirements section)