DNM: POC for LP user documentation

canonical · Sep 24, 2024 · aa10020 · aa10020
1 parent ce5408a
commit aa10020
Show file tree

Hide file tree

Showing 110 changed files with 487 additions and 26 deletions.
diff --git a/custom_conf.py b/custom_conf.py
@@ -101,7 +101,12 @@
 # Set up redirects (https://documatt.gitlab.io/sphinx-reredirects/usage.html)
 # For example: 'explanation/old-name.html': '../how-to/prettify.html',
 
-redirects = {}
+redirects = {
+    '/tutorials': '/developing-launchpad/tutorials',
+    '/how-to': '/developing-launchpad/how-to',
+    '/explanation': '/developing-launchpad/explanation',
+    '/reference': '/developing-launchpad/reference',
+}
 
 ############################################################
 ### Link checker exceptions

diff --git a/diagrams/architecture.html → ...ping-launchpad/diagrams/architecture.html b/diagrams/architecture.html → ...ping-launchpad/diagrams/architecture.html
diff --git a/explanation/architecture.rst → ...ng-launchpad/explanation/architecture.rst b/explanation/architecture.rst → ...ng-launchpad/explanation/architecture.rst
diff --git a/explanation/branches.rst → ...loping-launchpad/explanation/branches.rst b/explanation/branches.rst → ...loping-launchpad/explanation/branches.rst
diff --git a/explanation/charms.rst → developing-launchpad/explanation/charms.rst b/explanation/charms.rst → developing-launchpad/explanation/charms.rst
diff --git a/explanation/code.rst → developing-launchpad/explanation/code.rst b/explanation/code.rst → developing-launchpad/explanation/code.rst
diff --git a/explanation/codeimport.rst → ...ping-launchpad/explanation/codeimport.rst b/explanation/codeimport.rst → ...ping-launchpad/explanation/codeimport.rst
diff --git a/explanation/concepts.rst → ...loping-launchpad/explanation/concepts.rst b/explanation/concepts.rst → ...loping-launchpad/explanation/concepts.rst
diff --git a/explanation/css-sprites.rst → ...ing-launchpad/explanation/css-sprites.rst b/explanation/css-sprites.rst → ...ing-launchpad/explanation/css-sprites.rst
diff --git a/explanation/css.rst → developing-launchpad/explanation/css.rst b/explanation/css.rst → developing-launchpad/explanation/css.rst
diff --git a/explanation/database-performance.rst → ...hpad/explanation/database-performance.rst b/explanation/database-performance.rst → ...hpad/explanation/database-performance.rst
diff --git a/explanation/datetime-usage.rst → ...-launchpad/explanation/datetime-usage.rst b/explanation/datetime-usage.rst → ...-launchpad/explanation/datetime-usage.rst
diff --git a/...ion/engineering-overview-translations.rst → ...ion/engineering-overview-translations.rst b/...ion/engineering-overview-translations.rst → ...ion/engineering-overview-translations.rst
diff --git a/explanation/error-explanations.rst → ...nchpad/explanation/error-explanations.rst b/explanation/error-explanations.rst → ...nchpad/explanation/error-explanations.rst
diff --git a/explanation/favicon.rst → developing-launchpad/explanation/favicon.rst b/explanation/favicon.rst → developing-launchpad/explanation/favicon.rst
diff --git a/explanation/feature-flags.rst → ...g-launchpad/explanation/feature-flags.rst b/explanation/feature-flags.rst → ...g-launchpad/explanation/feature-flags.rst
diff --git a/explanation/framework.rst → ...oping-launchpad/explanation/framework.rst b/explanation/framework.rst → ...oping-launchpad/explanation/framework.rst
diff --git a/explanation/hacking.rst → developing-launchpad/explanation/hacking.rst b/explanation/hacking.rst → developing-launchpad/explanation/hacking.rst
diff --git a/explanation/images.rst → developing-launchpad/explanation/images.rst b/explanation/images.rst → developing-launchpad/explanation/images.rst
diff --git a/explanation/index.rst → developing-launchpad/explanation/index.rst b/explanation/index.rst → developing-launchpad/explanation/index.rst
diff --git a/explanation/javascript-buildsystem.rst → ...ad/explanation/javascript-buildsystem.rst b/explanation/javascript-buildsystem.rst → ...ad/explanation/javascript-buildsystem.rst
diff --git a/...nation/javascript-integration-testing.rst → ...nation/javascript-integration-testing.rst b/...nation/javascript-integration-testing.rst → ...nation/javascript-integration-testing.rst
diff --git a/explanation/javascript-unittesting.rst → ...ad/explanation/javascript-unittesting.rst b/explanation/javascript-unittesting.rst → ...ad/explanation/javascript-unittesting.rst
diff --git a/explanation/launchpad-ppa.rst → ...g-launchpad/explanation/launchpad-ppa.rst b/explanation/launchpad-ppa.rst → ...g-launchpad/explanation/launchpad-ppa.rst
diff --git a/explanation/live-patching.rst → ...g-launchpad/explanation/live-patching.rst b/explanation/live-patching.rst → ...g-launchpad/explanation/live-patching.rst
diff --git a/explanation/mail.rst → developing-launchpad/explanation/mail.rst b/explanation/mail.rst → developing-launchpad/explanation/mail.rst
diff --git a/explanation/malone.rst → developing-launchpad/explanation/malone.rst b/explanation/malone.rst → developing-launchpad/explanation/malone.rst
diff --git a/explanation/navigating.rst → ...ping-launchpad/explanation/navigating.rst b/explanation/navigating.rst → ...ping-launchpad/explanation/navigating.rst
diff --git a/explanation/navigation-menus.rst → ...aunchpad/explanation/navigation-menus.rst b/explanation/navigation-menus.rst → ...aunchpad/explanation/navigation-menus.rst
diff --git a/explanation/performance.rst → ...ing-launchpad/explanation/performance.rst b/explanation/performance.rst → ...ing-launchpad/explanation/performance.rst
diff --git a/explanation/pip.rst → developing-launchpad/explanation/pip.rst b/explanation/pip.rst → developing-launchpad/explanation/pip.rst
diff --git a/explanation/postgresql.rst → ...ping-launchpad/explanation/postgresql.rst b/explanation/postgresql.rst → ...ping-launchpad/explanation/postgresql.rst
diff --git a/explanation/pre-merge-reviews.rst → ...unchpad/explanation/pre-merge-reviews.rst b/explanation/pre-merge-reviews.rst → ...unchpad/explanation/pre-merge-reviews.rst
diff --git a/explanation/registry.rst → ...loping-launchpad/explanation/registry.rst b/explanation/registry.rst → ...loping-launchpad/explanation/registry.rst
diff --git a/explanation/running-details.rst → ...launchpad/explanation/running-details.rst b/explanation/running-details.rst → ...launchpad/explanation/running-details.rst
diff --git a/explanation/scope.rst → developing-launchpad/explanation/scope.rst b/explanation/scope.rst → developing-launchpad/explanation/scope.rst
diff --git a/explanation/security-policy.rst → ...launchpad/explanation/security-policy.rst b/explanation/security-policy.rst → ...launchpad/explanation/security-policy.rst
diff --git a/explanation/security.rst → ...loping-launchpad/explanation/security.rst b/explanation/security.rst → ...loping-launchpad/explanation/security.rst
diff --git a/explanation/storm-migration-guide.rst → ...pad/explanation/storm-migration-guide.rst b/explanation/storm-migration-guide.rst → ...pad/explanation/storm-migration-guide.rst
diff --git a/explanation/strategy.rst → ...loping-launchpad/explanation/strategy.rst b/explanation/strategy.rst → ...loping-launchpad/explanation/strategy.rst
diff --git a/explanation/template-reuse.rst → ...-launchpad/explanation/template-reuse.rst b/explanation/template-reuse.rst → ...-launchpad/explanation/template-reuse.rst
diff --git a/explanation/testing.rst → developing-launchpad/explanation/testing.rst b/explanation/testing.rst → developing-launchpad/explanation/testing.rst
diff --git a/explanation/url-traversal.rst → ...g-launchpad/explanation/url-traversal.rst b/explanation/url-traversal.rst → ...g-launchpad/explanation/url-traversal.rst
diff --git a/explanation/values.rst → developing-launchpad/explanation/values.rst b/explanation/values.rst → developing-launchpad/explanation/values.rst
diff --git a/explanation/webapp-process.rst → ...-launchpad/explanation/webapp-process.rst b/explanation/webapp-process.rst → ...-launchpad/explanation/webapp-process.rst
diff --git a/explanation/working-with-db-devel.rst → ...pad/explanation/working-with-db-devel.rst b/explanation/working-with-db-devel.rst → ...pad/explanation/working-with-db-devel.rst
diff --git a/explanation/xxx-policy.rst → ...ping-launchpad/explanation/xxx-policy.rst b/explanation/xxx-policy.rst → ...ping-launchpad/explanation/xxx-policy.rst
diff --git a/how-to/apply-schema-changes.rst → ...launchpad/how-to/apply-schema-changes.rst b/how-to/apply-schema-changes.rst → ...launchpad/how-to/apply-schema-changes.rst
diff --git a/how-to/chameleon.rst → developing-launchpad/how-to/chameleon.rst b/how-to/chameleon.rst → developing-launchpad/how-to/chameleon.rst
diff --git a/...g-availability-of-launchpad-frontends.rst → ...g-availability-of-launchpad-frontends.rst b/...g-availability-of-launchpad-frontends.rst → ...g-availability-of-launchpad-frontends.rst
diff --git a/how-to/common-development-tasks.rst → ...chpad/how-to/common-development-tasks.rst b/how-to/common-development-tasks.rst → ...chpad/how-to/common-development-tasks.rst
diff --git a/how-to/contributing-changes.rst → ...launchpad/how-to/contributing-changes.rst b/how-to/contributing-changes.rst → ...launchpad/how-to/contributing-changes.rst
diff --git a/how-to/create-bot-account.rst → ...g-launchpad/how-to/create-bot-account.rst b/how-to/create-bot-account.rst → ...g-launchpad/how-to/create-bot-account.rst
diff --git a/how-to/create-job-publish-artifact.rst → ...ad/how-to/create-job-publish-artifact.rst b/how-to/create-job-publish-artifact.rst → ...ad/how-to/create-job-publish-artifact.rst
diff --git a/how-to/database-schema-changes-process.rst → ...ow-to/database-schema-changes-process.rst b/how-to/database-schema-changes-process.rst → ...ow-to/database-schema-changes-process.rst
diff --git a/how-to/database-setup.rst → ...oping-launchpad/how-to/database-setup.rst b/how-to/database-setup.rst → ...oping-launchpad/how-to/database-setup.rst
diff --git a/how-to/debug-buildfarm-builder.rst → ...nchpad/how-to/debug-buildfarm-builder.rst b/how-to/debug-buildfarm-builder.rst → ...nchpad/how-to/debug-buildfarm-builder.rst
diff --git a/...o/debug-tests-with-visual-studio-code.rst → ...o/debug-tests-with-visual-studio-code.rst b/...o/debug-tests-with-visual-studio-code.rst → ...o/debug-tests-with-visual-studio-code.rst
diff --git a/how-to/deploying-configuration-changes.rst → ...ow-to/deploying-configuration-changes.rst b/how-to/deploying-configuration-changes.rst → ...ow-to/deploying-configuration-changes.rst
diff --git a/how-to/develop-with-buildd.rst → ...-launchpad/how-to/develop-with-buildd.rst b/how-to/develop-with-buildd.rst → ...-launchpad/how-to/develop-with-buildd.rst
diff --git a/how-to/exceptions.rst → developing-launchpad/how-to/exceptions.rst b/how-to/exceptions.rst → developing-launchpad/how-to/exceptions.rst
diff --git a/how-to/fixing-bugs.rst → developing-launchpad/how-to/fixing-bugs.rst b/how-to/fixing-bugs.rst → developing-launchpad/how-to/fixing-bugs.rst
diff --git a/how-to/getting-overview-of-build-farm.rst → ...how-to/getting-overview-of-build-farm.rst b/how-to/getting-overview-of-build-farm.rst → ...how-to/getting-overview-of-build-farm.rst
diff --git a/how-to/getting-started.rst → ...ping-launchpad/how-to/getting-started.rst b/how-to/getting-started.rst → ...ping-launchpad/how-to/getting-started.rst
diff --git a/how-to/getting.rst → developing-launchpad/how-to/getting.rst b/how-to/getting.rst → developing-launchpad/how-to/getting.rst
diff --git a/how-to/importing-an-ubuntu-package.rst → ...ad/how-to/importing-an-ubuntu-package.rst b/how-to/importing-an-ubuntu-package.rst → ...ad/how-to/importing-an-ubuntu-package.rst
diff --git a/how-to/index.rst → developing-launchpad/how-to/index.rst b/how-to/index.rst → developing-launchpad/how-to/index.rst
diff --git a/how-to/land-update-for-loggerhead.rst → ...pad/how-to/land-update-for-loggerhead.rst b/how-to/land-update-for-loggerhead.rst → ...pad/how-to/land-update-for-loggerhead.rst
diff --git a/how-to/launchpad-development-tips.rst → ...pad/how-to/launchpad-development-tips.rst b/how-to/launchpad-development-tips.rst → ...pad/how-to/launchpad-development-tips.rst
diff --git a/how-to/manage-users.rst → developing-launchpad/how-to/manage-users.rst b/how-to/manage-users.rst → developing-launchpad/how-to/manage-users.rst
diff --git a/how-to/operating-launchpad.rst → ...-launchpad/how-to/operating-launchpad.rst b/how-to/operating-launchpad.rst → ...-launchpad/how-to/operating-launchpad.rst
diff --git a/...ing-builders-to-newer-ubuntu-versions.rst → ...ing-builders-to-newer-ubuntu-versions.rst b/...ing-builders-to-newer-ubuntu-versions.rst → ...ing-builders-to-newer-ubuntu-versions.rst
diff --git a/how-to/preserve-query-count.rst → ...launchpad/how-to/preserve-query-count.rst b/how-to/preserve-query-count.rst → ...launchpad/how-to/preserve-query-count.rst
diff --git a/how-to/running.rst → developing-launchpad/how-to/running.rst b/how-to/running.rst → developing-launchpad/how-to/running.rst
diff --git a/how-to/security.rst → developing-launchpad/how-to/security.rst b/how-to/security.rst → developing-launchpad/how-to/security.rst
diff --git a/how-to/testing-scripts.rst → ...ping-launchpad/how-to/testing-scripts.rst b/how-to/testing-scripts.rst → ...ping-launchpad/how-to/testing-scripts.rst
diff --git a/how-to/transfer-project-ownership.rst → ...pad/how-to/transfer-project-ownership.rst b/how-to/transfer-project-ownership.rst → ...pad/how-to/transfer-project-ownership.rst
diff --git a/how-to/triage-bugs.rst → developing-launchpad/how-to/triage-bugs.rst b/how-to/triage-bugs.rst → developing-launchpad/how-to/triage-bugs.rst
diff --git a/how-to/update-configuration-for-testing.rst → ...w-to/update-configuration-for-testing.rst b/how-to/update-configuration-for-testing.rst → ...w-to/update-configuration-for-testing.rst
diff --git a/how-to/use-soyuz-locally.rst → ...ng-launchpad/how-to/use-soyuz-locally.rst b/how-to/use-soyuz-locally.rst → ...ng-launchpad/how-to/use-soyuz-locally.rst
diff --git a/how-to/use-updated-dependency.rst → ...unchpad/how-to/use-updated-dependency.rst b/how-to/use-updated-dependency.rst → ...unchpad/how-to/use-updated-dependency.rst
diff --git a/how-to/using-breakpoints.rst → ...ng-launchpad/how-to/using-breakpoints.rst b/how-to/using-breakpoints.rst → ...ng-launchpad/how-to/using-breakpoints.rst
diff --git a/images/IPerson-hello.png → ...loping-launchpad/images/IPerson-hello.png b/images/IPerson-hello.png → ...loping-launchpad/images/IPerson-hello.png
diff --git a/images/codehosting.png → developing-launchpad/images/codehosting.png b/images/codehosting.png → developing-launchpad/images/codehosting.png
diff --git a/images/cross-project-collab.svg → ...launchpad/images/cross-project-collab.svg b/images/cross-project-collab.svg → ...launchpad/images/cross-project-collab.svg
diff --git a/images/favicon.png → developing-launchpad/images/favicon.png b/images/favicon.png → developing-launchpad/images/favicon.png
diff --git a/images/logo.png → developing-launchpad/images/logo.png b/images/logo.png → developing-launchpad/images/logo.png
diff --git a/images/scope.svg → developing-launchpad/images/scope.svg b/images/scope.svg → developing-launchpad/images/scope.svg
diff --git a/images/value-flow.svg → developing-launchpad/images/value-flow.svg b/images/value-flow.svg → developing-launchpad/images/value-flow.svg
diff --git a/developing-launchpad/index.rst b/developing-launchpad/index.rst
@@ -0,0 +1,70 @@
+Developing Launchpad
+====================
+
+**Launchpad is a collaboration platform for open-source projects.**
+
+**Launchpad provides everything necessary to build and publish software,
+including code hosting, issue tracking, translations,
+and request tracking for bugs and features.**
+The most famous software hosted on Launchpad is Ubuntu.
+
+**Launchpad provides unique features needed in modern software development,
+especially in open-source development.**
+These include build capacities for many different languages and package formats
+across standard architectures, but also including rising stars such as RISC-V
+and ARM. Launchpad also offers unparalleled tracking capabilities across issue
+trackers to seamlessly communicate with upstream projects.
+
+**With its unique features, Launchpad is the right tool for companies,
+professionals, open-source maintainers, and hobbyists alike.**
+
+
+
+---------
+
+In this documentation
+---------------------
+
+..  grid:: 1 1 2 2
+
+   ..  grid-item:: :doc:`Tutorials <tutorials/index>`
+
+       **Start here** - hands-on introductions to Launchpad for new developers
+
+   ..  grid-item:: :doc:`How-to guides <how-to/index>`
+
+      **How-to guides** - step-by-step guides covering key operations and common tasks
+
+.. grid:: 1 1 2 2
+   :reverse:
+
+   .. grid-item:: :doc:`Reference <reference/index>`
+
+      **Technical information** - specifications, APIs, architecture
+
+   .. grid-item:: :doc:`Explanation <explanation/index>`
+
+      **Discussion and clarification** of key topics
+
+---------
+
+Project and community
+---------------------
+
+Launchpad is a member of the Ubuntu family.
+It's an open source project that warmly welcomes community projects,
+contributions, suggestions, fixes and constructive feedback.
+
+* `Code of conduct <https://ubuntu.com/community/ethos/code-of-conduct>`_
+* :doc:`Get support <help>`
+* :doc:`Contribute to our code <how-to/contributing-changes>`
+* :doc:`Contribute to our docs <contribute-to-our-docs>`
+
+.. toctree::
+   :hidden:
+   :maxdepth: 2
+
+   tutorials/index
+   how-to/index
+   reference/index
+   explanation/index
diff --git a/reference/css.rst → developing-launchpad/reference/css.rst b/reference/css.rst → developing-launchpad/reference/css.rst
diff --git a/reference/email.rst → developing-launchpad/reference/email.rst b/reference/email.rst → developing-launchpad/reference/email.rst
diff --git a/reference/index.rst → developing-launchpad/reference/index.rst b/reference/index.rst → developing-launchpad/reference/index.rst
diff --git a/reference/python.rst → developing-launchpad/reference/python.rst b/reference/python.rst → developing-launchpad/reference/python.rst
diff --git a/...ervices/automatic-translations-export.rst → ...ervices/automatic-translations-export.rst b/...ervices/automatic-translations-export.rst → ...ervices/automatic-translations-export.rst
diff --git a/reference/services/build-farm.rst → ...unchpad/reference/services/build-farm.rst b/reference/services/build-farm.rst → ...unchpad/reference/services/build-farm.rst
diff --git a/reference/services/fetch-service.rst → ...hpad/reference/services/fetch-service.rst b/reference/services/fetch-service.rst → ...hpad/reference/services/fetch-service.rst
diff --git a/reference/services/git-hosting.rst → ...nchpad/reference/services/git-hosting.rst b/reference/services/git-hosting.rst → ...nchpad/reference/services/git-hosting.rst
diff --git a/reference/services/mirror-prober.rst → ...hpad/reference/services/mirror-prober.rst b/reference/services/mirror-prober.rst → ...hpad/reference/services/mirror-prober.rst
diff --git a/reference/services/signing.rst → ...-launchpad/reference/services/signing.rst b/reference/services/signing.rst → ...-launchpad/reference/services/signing.rst
diff --git a/reference/tests.rst → developing-launchpad/reference/tests.rst b/reference/tests.rst → developing-launchpad/reference/tests.rst
diff --git a/tutorials/creating-a-page-in-launchpad.rst → ...utorials/creating-a-page-in-launchpad.rst b/tutorials/creating-a-page-in-launchpad.rst → ...utorials/creating-a-page-in-launchpad.rst
diff --git a/tutorials/index.rst → developing-launchpad/tutorials/index.rst b/tutorials/index.rst → developing-launchpad/tutorials/index.rst
diff --git a/index.rst b/index.rst
@@ -27,26 +27,7 @@ professionals, open-source maintainers, and hobbyists alike.**
 In this documentation
 ---------------------
 
-..  grid:: 1 1 2 2
-
-   ..  grid-item:: :doc:`Tutorials <tutorials/index>`
-
-       **Start here** - hands-on introductions to Launchpad for new developers
-
-   ..  grid-item:: :doc:`How-to guides <how-to/index>`
-
-      **How-to guides** - step-by-step guides covering key operations and common tasks
-
-.. grid:: 1 1 2 2
-   :reverse:
-
-   .. grid-item:: :doc:`Reference <reference/index>`
-
-      **Technical information** - specifications, APIs, architecture
-
-   .. grid-item:: :doc:`Explanation <explanation/index>`
-
-      **Discussion and clarification** of key topics
+We have documentation for Launchpad users and developers.
 
 ---------
 
@@ -64,11 +45,17 @@ contributions, suggestions, fixes and constructive feedback.
 
 .. toctree::
    :hidden:
-   :maxdepth: 2
 
-   tutorials/index
-   how-to/index
-   reference/index
-   explanation/index
+   developing-launchpad/index
+
+.. toctree::
+   :hidden:
+
+   using-launchpad/index
+
+.. toctree::
+   :hidden:
+
    help
    contribute-to-our-docs
+
diff --git a/using-launchpad/explanation/index.rst b/using-launchpad/explanation/index.rst
@@ -0,0 +1,83 @@
+:hide-toc:
+
+Explanation
+===========
+.. toctree::
+   :maxdepth: 1
+
+
+The following are suggesting titles and topics for classification under explanation:
+
+- `Launchpad <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/WhatIsLaunchpad.rst>`_
+  - `Account <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/YourAccount.rst>`_
+  - `Collaborating using Launchpad <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/YourAccountContactingPeople.rst>`_
+  - `Karma <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/YourAccountKarma.rst>`_
+- Launchpad features
+
+  - `Answer tracker <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsAnswerTracker.rst>`_ - This could also include relevant bits from the answers topic in the next launchpad answers section.
+  - `Code hosting using Bazaar <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsBazaarHosting.rst>`_
+  - `Blueprints <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsBlueprintReleasePlanning.rst>`_
+  - `Branch imports <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsBranchImports.rst>`_ - this feels very related to the `how-to guide <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/CodeUploadingABranch.rst>`_. 
+  -  Bug tracker 
+   (Combine explanation from the following topics into a bug tracker topic and keep steps isolated in how-to guides.)
+
+    - `Landing page for bug tracker <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/BugReportingTool.rst>`_ - explain bug tracker and its abilities but not steps to report a bug.
+
+      - Also add https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/BugsYourProject.rst - Introduction to bug tracker
+      - Also add https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/BugTrackingHighlights.rst - Introduction to bug tracker
+
+    - `Bug watch <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsBugWatches.rst>`_
+    - `Linking bug to branch <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsBugBranchLinking.rst>`_
+    - `Managing bugs through email <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsBugsByEmail.rst>`_ and `Bug email interface <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/BugsEmailInterface.rst>`_ - consider merging
+  - `Milestones <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsMilestoneUsage.rst>`_
+  - `Pages <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsPageLayout.rst>`_
+  - `Personal Package Archives (PPA) <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsPersonalPackageArchives.rst>`_
+  - `Product series <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsProductSeries.rst>`_
+  - `Teams <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsTeamManagement.rst>`_ and `Team branches <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/FeatureHighlightsTeamBranches.rst>`_ - can be merged into one topic titled "Team management"
+  - `OOPs reports <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/Oops.rst>`_
+  - `Support tracker <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/SupportTrackerTour.rst>`_
+  - `Staging environment <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/StagingServer.rst>`_
+  - `Launchpad mailing lists <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/ListHelp.rst>`_ - some steps can be extracted to a how-to guide on using Launchpad mailing lists. This how-to guide should contain subscribing, using and unsubscribing.
+    - Also merge `Indirect team members <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/HelpTeamsIndirect.rst>`_
+
+  - `Packaging <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/Packaging.rst>`_ - Right now this is just a brief overview and some links to related topics. Rewrite this into an explanation about Packaging as a feature
+    - `Source package recipes <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/PackagingSourceBuilds.rst>`_
+    - `Source build recipes <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/PackagingSourceBuildsRecipes.rst>`_
+  - `Projects in Launchpad <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/Projects.rst>`_
+
+    (Consolidate the following topics for explaining projects in LP; Move any actions to how-to guides)
+    - `Registering your project in LP <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/ProjectsRegistering.rst>`_
+    - `Closing a project <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/ProjectsClosing.rst>`_
+    - `Publishing files for download <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/ProjectsFileDownloads.rst>`_
+    - `Terminator <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/ProjectsAnnouncements.rst>`_
+    - `Understanding project series, milestones and releases <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/ProjectsSeriesMilestonesReleases.rst>`_
+    - `Providing support for your project <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/ProvidingSupportThroughLaunchpad.rst>`_
+
+  - `Translating your project <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/RosettaHighlights.rst>`_
+    - Also merge https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/Translations.rst and https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/TranslationsYourProject.rst
+    - `Translation groups <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/TranslationsJoiningATranslationGroup.rst>`_ (also merge https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/TranslationsYourProjectChoosingAGroup.rst)
+    - `Translation exports <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/TranslationsYourProjectExports.rst>`_
+
+  - `Launchpad Teams <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/Teams.rst>`_
+    - `Creating and maintaining team <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/TeamsCreatingAndRunning.rst>`_
+    - 
+
+  - Launchpad answers
+  (This could possibly go in the project and community section as well but needs to be very concise. If it is more detailed and presented as feature, let's retain it under Diataxis categories)
+
+    - `Answers <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/Answers.rst>`_
+    - `Answer tracker <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/AnswerTrackerDocumentation.rst>`_ - If possible, combine both answers and answer tracker
+    - `Ask for help <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/AnswersAskingForHelp.rst>`_ - excluding the how to ask for help part
+    - `Offer help <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/AnswersOfferingHelp.rst>`_ - excluding steps on how to offer
+
+- Launchpad API
+
+  - `launchpadlib <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/APIlaunchpadlib.rst>`_ - Some explanation of what's launchpadlib and the tutorial should link here.
+  - `Lauchpad resources <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/APIHacking.rst>`_ - information about LP resources need to be separated out as explanation
+
+- Working with code
+
+  - `Launchpad CI <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/CodeContinuousIntegration.rst>`_ - Just the overview about LPCI
+  - `Git Hosting <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/CodeGit.rst>`_ - The overview and supported versions can be condensed into an explanation. Ideally supported features will be a reference but we can keep it with the explanation until there is much more reference material to add.
+  - `Code Imports <https://github.com/canonical/help.launchpad.net-migration/blob/main/keep/CodeImports.rst>`_
+  - Merge proposal - Although this is common knowledge, there should be a topic explaining what an MP is and linked to the corresponding how-to guide on how to create an MP. Content of this file can be created from scratch or pulled in from the overview of the how-to guide