[ https://ovirt-jira.atlassian.net/browse/OVIRT-1707?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Barak Korren updated OVIRT-1707:

Epic Link: OVIRT-403

The infra docs index page needs a face lift

     Key: OVIRT-1707
     URL: https://ovirt-jira.atlassian.net/browse/OVIRT-1707
 Project: oVirt - virtualization made easy
         Issue Type: Improvement
         Components: General
Reporter: Barak Korren
Assignee: infra
Priority: High
  Labels: documentation

The infra-docs index page is the first page about the oVirt infra team that anyone will see, but it looks bad. Here are a few issues with it: # The page title was probably auto-generated by GitHub and looks wrong # The page contains no text. There needs to be some short 2-3 line explanation about what is this page and what could be found in it. The sub sections should probably also include 1-2 lines each about which documents can be found in them. # Some links have opaque non-descriptive text. For example “Communication” should probably be “Communicating with the oVirt infra team”. # The documents and sections are listed in semi-random order. Instead, they should be ordered in such a way that the more important public-facing documents are closer to the top # The “general” section is just a random collection of things. It should probably be split apart into more specific sections like “Gerrit”, “Contribution guidelines” and “Procedures for infra-team members”.

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