Refresh oVirt Gerrit Hooks documentation ----------------------------------------- Key: OVIRT-1676 URL: https://ovirt-jira.atlassian.net/browse/OVIRT-1676 Project: oVirt - virtualization made easy Issue Type: Task Components: Gerrit/git Reporter: eyal edri Assignee: infra Priority: High There has been a lot of work done and improvements around the oVirt Gerrit Hooks in the past year, including refactoring of the whole projects, moving to Python, adding new hooks and consolidating libraries. However, the official documentation for it has remained outdated and doesn't reflect the latest updates. We need to go over all current docs and refresh it with new updated content ( i.e remove obsolete info and add info on the new stuff ). The current locations (at least that I'm aware of) that needs updating: * ovirt.org: https://ovirt.org/develop/infra/gerrit-hooks/ * I recommend to remove this page and add a link to gerrit-hooks readthedocs page instead * However, I would recommend adding a section on it here https://ovirt.org/develop/dev-process/working-with-gerrit/ and mentioning that each project has various hooks that adds automation and verfication. * oVirt infra RTD: http://ovirt-infra-docs.readthedocs.io/en/latest/CI/Gerrit_Hooks/index.html * This needs a refresh and should focus on how to deploy hooks on a project, enable different suites, type of suites, etc.. ( so basically a simple "user guide" or usage guide ) * Gerrit Hooks RTD: http://ovirt-gerrit-hooks.readthedocs.io/en/latest/ * This should be completely refactored, as the design and code changed significantly * The first section should be aimed at infra team, explaining the design of the project, deployment on the Gerrit server, steps to deploy new code, and anything admin would need to know about the project * The second section should be auto-generated from the code itself and show the documentation on all the classes and functions. [~sbendavi(a)redhat.com][~amarchuk] I think we can take advantage of the quiet time during the shutdown to start focusing on this important task and get some progress. Let me know if I missed anything.