Tune project admin dashboard navigation menu

- Alter the admin navigation listing for use with organizations
- Make docs listing less redundant with headers

Author: agjohnson

readthedocsext/theme/templates/projects/edit_base.html

@@ -26,9 +26,16 @@
         <a class="item {% block project_domains_active %}{% endblock %}" href="{% url "projects_domains" project.slug %}">
           {% trans "Domains" %}
         </a>
-        <a class="item {% block project_users_active %}{% endblock %}" href="{% url "projects_users" project.slug %}">
-          {% trans "Maintainers" %}
-        </a>
+        {% if not USE_ORGANIZATIONS %}
+          <a class="item {% block project_users_active %}{% endblock %}" href="{% url "projects_users" project.slug %}">
+            {% trans "Maintainers" %}
+          </a>
+        {% endif %}
+        {% if USE_ORGANIZATIONS %}
+          <a class="item {% block project_access_tokens_active %}{% endblock %}" href="{% url "projects_temporary_access_list" project.slug %}">
+            {% trans "Sharing" %}
+          </a>
+        {% endif %}
         <a class="item {% block project_translations_active %}{% endblock %}" href="{% url "projects_translations" project.slug %}">
           {% trans "Translations" %}
         </a>
@@ -38,6 +45,11 @@
         <a class="item {% block project_integrations_active %}{% endblock %}" href="{% url "projects_integrations" project.slug %}">
           {% trans "Integrations" %}
         </a>
+        {% if USE_ORGANIZATIONS %}
+          <a class="item {% block project_keys_active %}{% endblock %}" href="{% url "projects_keys" project.slug %}">
+            {% trans "SSH keys" %}
+          </a>
+        {% endif %}
         <a class="item {% block project_environment_variables_active %}{% endblock %}" href="{% url "projects_environmentvariables" project.slug %}">
           {% trans "Environment variables" %}
         </a>
@@ -71,11 +83,13 @@
         {% block project_edit_sidebar_help_topics_container %}
           <div class="ui basic segment">
             <h2 class="ui small header">{% trans "Help topics" %}</h2>
-            <div class="ui bulleted list">
-              {% block project_edit_sidebar_help_topics %}
-              {% endblock project_edit_sidebar_help_topics %}
-              {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/" text=_("Documentation index") is_external=True class="item" %}
-            </div>
+            {% block project_edit_sidebar_help_topics_content %}
+              <div class="ui bulleted list">
+                {% block project_edit_sidebar_help_topics %}
+                {% endblock project_edit_sidebar_help_topics %}
+                {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/" text=_("Documentation index") is_external=True class="item" %}
+              </div>
+            {% endblock project_edit_sidebar_help_topics_content %}
           </div>
         {% endblock project_edit_sidebar_help_topics_container %}
 

readthedocsext/theme/templates/projects/settings_basics_form.html

@@ -61,11 +61,16 @@ <h3 class="ui small header">
   </div>
 {% endblock %}
 
-{% block project_edit_sidebar_help_topics %}
-  {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/tutorial/index.html" text="Tutorial: Getting started" is_external=True class="item" %}
-  {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/intro/getting-started-with-sphinx.html" text="Tutorial: Getting started with Sphinx" is_external=True class="item" %}
-  {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/intro/getting-started-with-mkdocs.html" text="Tutorial: Getting started with MkDocs" is_external=True class="item" %}
-  {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/intro/import-guide.html" text="Tutorial: Importing your documentation" is_external=True class="item" %}
-  {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/config-file/v2.html" text="Reference for the .readthedocs.yaml configuration file" is_external=True class="item" %}
-  {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/en/stable/faq.html#how-do-i-change-my-project-slug-the-url-your-docs-are-served-at" text="How do I change my project slug (the URL your docs are served at)?" is_external=True class="item" %}
-{% endblock project_edit_sidebar_help_topics %}
+{% block project_edit_sidebar_help_topics_content %}
+  <div class="ui mini header">{% trans "Tutorials" %}</div> 
+  <div class="ui bulleted list">
+    {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/tutorial/index.html" text="Getting started" is_external=True class="item" %}
+    {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/intro/getting-started-with-sphinx.html" text="Getting started with Sphinx" is_external=True class="item" %}
+    {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/intro/getting-started-with-mkdocs.html" text="Getting started with MkDocs" is_external=True class="item" %}
+    {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/intro/import-guide.html" text="Importing your documentation" is_external=True class="item" %}
+  </div>
+  <div class="ui mini header">{% trans "Resources" %}</div> 
+  <div class="ui bulleted list">
+    {% include "includes/elements/link.html" with url="https://docs.readthedocs.io/page/config-file/v2.html" text="Configuration file" is_external=True class="item" %}
+  </div>
+{% endblock project_edit_sidebar_help_topics_content %}