<!--
THE INSTALLATION SECTION IS GENERATED

Do not edit here, but in docs/installation/.

-->
{% for platform, tools in structure %}
    - [{{ platform }}](#{{ platform.lower() }}){% endfor %} {# <= keep `endfor` here to prevent unwanted `\n` #}

{% for platform, tools in structure %}

    ### {{ platform }}

    {% for tool in tools %}
        #### {{ tool.title }}

        {% if tool.note %}
            {{ tool.note }}
        {% endif %}

        {% if tool.links.setup %}
            To install [{{ tool.name }}]({{ tool.links.homepage }}) follow [installation instructions]({{ tool.links.setup }}).
        {% endif %}

        ```bash
        # Install
        $ {{ tool.commands.install|join('\n$ ') }}
        ```

        ```bash
        # Upgrade
        $ {{ tool.commands.upgrade|join('\n$ ') }}
        ```
    {% endfor %}

{% endfor %}
<!-- /GENERATED SECTION -->