Barak Korren created OVIRT-1707:
-----------------------------------

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


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)
_______________________________________________
Infra mailing list
Infra@ovirt.org
http://lists.ovirt.org/mailman/listinfo/infra

Reply via email to