Individual product documentation pages define and reference product icons at the top of page, rather than site-wide.
Desired
All existing product icons referenced across the docs site are defined once, site-wide, so that they can be referenced using only a short code on individual docs pages, as needed.
Effort
Identify all unique product icons referenced across all pages of the Mattermost product documentation. Product icon references will be located at the top of docs pages in the following format:
Create a docs PR that defines all identified product icons in the /source/conf.py file located in this GitHub repository, within the rst_prolog section, as follows:
rst_prolog = """
.. |plans-img| image:: /_static/images/badges/flag_icon.svg
:class: mm-badge-flag
.. |deployment-img| image:: /_static/images/badges/deployment_icon.svg
:class: mm-badge-flag
.. |plans-img-yellow| image:: /_static/images/badges/flag_icon_yellow.svg
:class: mm-badge-flag
.. |deployment-img-yellow| image:: /_static/images/badges/deployment_icon_yellow.svg
:class: mm-badge-deployment
<your icon definitions go here following the same format>
"""
Remove the individual page-based icon definition code as you move definitions over.
Ensure that there are no duplicate icon definitions in conf.py.
Generate and test the docs to ensure that all product icons display correctly in both Light and Dark Mode using the :class: theme-icon attribute.
Current
Individual product documentation pages define and reference product icons at the top of page, rather than site-wide.
Desired
All existing product icons referenced across the docs site are defined once, site-wide, so that they can be referenced using only a short code on individual docs pages, as needed.
Effort
/source/conf.py
file located in this GitHub repository, within therst_prolog
section, as follows:conf.py
.:class: theme-icon
attribute.