eyal edri created OVIRT-1676:

   Summary: 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@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.

— This message was sent by Atlassian Jira (v1001.0.0-SNAPSHOT#100063)