Add contribution guides. (#2605)

Author: kattni

changes/2605.doc.md

@@ -0,0 +1 @@
+New contribution guide series now available in the Briefcase documentation.

docs/config.yml

@@ -14,6 +14,11 @@ validation:
 extra:
   project_name: briefcase
   package_name: briefcase
+  formal_name: Briefcase
+  min_python_version: "3.10"  # The oldest supported Python version
+  min_python_version_tag: "310"  # The tag version of the minimum python version
+  recent_python_version: "3.13"  # The newest Python version known to work on all platforms
+  docs_python_version: "3.13"  # The version of Python required to build the documentation
   social:
     - icon: fontawesome/brands/github
       link: https://github.com/beeware
@@ -71,6 +76,7 @@ markdown_extensions:
   pymdownx.superfences: {}
   pymdownx.blocks.admonition: {}
   pymdownx.blocks.caption: {}
+  pymdownx.details: {}
   pymdownx.blocks.tab:
     alternate_style: true
   pymdownx.snippets:

docs/en/SUMMARY.md

@@ -20,8 +20,34 @@
     - Publishing your app
         - ./how-to/publishing/*
     - [Contributing to Briefcase](how-to/contribute/index.md)
-        - [Contributing code to Briefcase](how-to/contribute/code.md)
-        - [Contributing to the documentation](how-to/contribute/docs.md)
+        - [First-time contributors](how-to/contribute/first_time_contributors.md)
+        - What can I do?
+            - [Fix an issue](how-to/contribute/what/fix_issue.md)
+            - [Implement a new feature](how-to/contribute/what/implement_feature.md)
+            - [Write documentation](how-to/contribute/what/write_docs.md)
+            - [Triage an issue](how-to/contribute/what/triage.md)
+            - [Review a pull request](how-to/contribute/what/review_pr.md)
+            - [Propose a new feature](how-to/contribute/what/propose_feature.md)
+            - [Use the tools](how-to/contribute/what/use_tools.md)
+        - How do I contribute?
+            - [Setting up a development environment](how-to/contribute/how/dev_environment.md)
+            - [Reproducing an issue](how-to/contribute/how/reproduce_issue.md)
+            - [Working from a branch](how-to/contribute/how/branches.md)
+            - [Avoiding scope creep](how-to/contribute/how/scope_creep.md)
+            - [Writing, running, and testing code](how-to/contribute/how/write_code.md)
+            - [Building documentation](how-to/contribute/how/build_docs.md)
+            - [Writing documentation](how-to/contribute/how/write_docs.md)
+            - [Adding a change note](how-to/contribute/how/change_note.md)
+            - [Submitting a pull request](how-to/contribute/how/submit_pr.md)
+            - [Providing a review](how-to/contribute/how/review_pr.md)
+            - [Submitting a new issue](how-to/contribute/how/new_issue.md)
+            - [Proposing a new feature](how-to/contribute/how/propose_feature.md)
+        - What happens next?
+            - [Pull request review process](how-to/contribute/next/pr_review.md)
+            - [Release process](how-to/contribute/next/release.md)
+        - Style guides
+            - [Code style guide](how-to/contribute/style/code_style_guide.md)
+            - [Documentation style guide](how-to/contribute/style/docs_style_guide.md)
     - Internal How-to guides
         - [How to cut a Briefcase release](how-to/internal/release.md)
     - Upgrading from previous versions

docs/en/how-to/building/external-apps.md

@@ -34,7 +34,7 @@ In the process of packaging an external app, Briefcase will generate an applicat
 
 The files generated by the template should *not* be modified by hand. If you need to customize the contents of these templated files, you should use Briefcase app configuration settings to define those changes. For example, on macOS if you need to add an entitlement for signing purposes, you should *not* modify the templated `Entitlements.plist` file by hand - you should use the [`entitlement`][] setting in your `pyproject.toml`.
 
-If Briefcase's configuration options are not sufficient for your requirements, you can either fork the template used by Briefcase and use the [`template`][] option to point at your custom template; or you can [submit a pull request to Briefcase][contribute] to support your customization use case.
+If Briefcase's configuration options are not sufficient for your requirements, you can either fork the template used by Briefcase and use the [`template`][] option to point at your custom template; or you can [submit a pull request to Briefcase](../contribute/how/submit_pr.md) to support your customization use case.
 
 ## Packaging an external app