Add content scoring docs page (#1418)

Signed-off-by: Andrew Crosby <[email protected]>

docs/docsite/rst/contributing/content_scoring.rst

@@ -0,0 +1,68 @@
+.. _content_scoring:
+
+***************
+Content Scoring
+***************
+
+.. contents:: Topics
+
+
+This topic describes how content is scored.
+
+Scores displayed when browsing content are the average of
+the content's Community Score and Quality Score.
+Content Scoring is in early iterations, to be improved with
+user feedback and future additions to ansible-lint.
+
+Community Score
+===============
+
+* The Community Score is calculated from community surveys submitted by Galaxy users
+* Maximum score of ``5.0``
+
+Quality Score
+=============
+
+* The Quality Score is based on analysis from ``yamllint`` ``ansible-lint`` and import-time checks
+* Maximum score is ``5.0``
+* The Quality Score is the average of `Syntax Score <syntax-score_>`_ and `Metadata Score <metadata-score_>`_
+
+.. note::
+   Scoring is only done at import, to re-score please re-import
+
+Linters Used
+------------
+
+* ``yamllint`` is run with a `custom config <https://github.com/ansible/galaxy/blob/devel/galaxy/importer/linters/yamllint.yaml>`_
+* ``ansible-lint`` is run using its default rules, for information on how to fix Ansible Lint issues, see the descriptions in the `default rules <https://docs.ansible.com/ansible-lint/rules/default_rules.html>`_
+* import-time checks reference the Galaxy database, checking for valid platforms, valid cloud platforms, and loadable dependencies
+
+.. _syntax-score:
+
+Syntax Score
+------------
+Linter issues applied to the Syntax Score are ``yamllint`` and non-metadata ``ansible-lint``
+
+Each linter issue is subtracted from a max score of ``5.0``:
+
+* Issue severity of "VERY_HIGH" reduces the score by ``1.0``
+* Issue severity of "HIGH" reduces the score by ``0.5``
+* Issue severity of "MEDIUM" reduces the score by ``0.25``
+* Issue severity of "LOW" reduces the score by ``0.125``
+* Issue severity of "VERY_LOW" reduces the score by ``0.075``
+* Issue severity of "INFO" does not reduce the score
+
+.. _metadata-score:
+
+Metadata Score
+--------------
+Linter issues applied to the Syntax Score are metadata ``ansible-lint`` and import-time checks
+
+Each linter issue is subtracted from a max score of ``5.0``:
+
+* Issue severity of "VERY_HIGH" reduces the score by ``1.0``
+* Issue severity of "HIGH" reduces the score by ``0.5``
+* Issue severity of "MEDIUM" reduces the score by ``0.25``
+* Issue severity of "LOW" reduces the score by ``0.125``
+* Issue severity of "VERY_LOW" reduces the score by ``0.075``
+* Issue severity of "INFO" does not reduce the score

docs/docsite/rst/contributing/index.rst

@@ -12,4 +12,5 @@ Contributing Content
    creating_apb
    version
    importing
+   content_scoring
    deprecate