active language

Author: jukent

CONTRIBUTING.md

@@ -1,8 +1,7 @@
-# Pythia Portal contributor's guide
+# Contributing to the Project Pythia Portal
 
 This document contains information specific to contributing to the
-Project Pythia Portal. Please first refer to [Pythia Contributor's
-Guide](https://projectpythia.org/pythia-contributing.html) for overall
+Project Pythia Portal. Please first refer to [Guide for Contributing to Project Pythia](https://projectpythia.org/contributing.html) for overall
 contribution guidelines (such as detailed description of Project
 Pythia structure, forking, repository cloning, branching, etc.).
 

myst.yml

@@ -17,7 +17,7 @@ project:
     - title: Blog
       children:
         - pattern: portal/posts/*.md
-    - file: portal/pythia-contributing.md
+    - file: portal/contributing.md
     - file: portal/cookbook-guide.md
     - file: portal/quick-cookbook-guide.md
     - file: portal/metrics.md

portal/pythia-contributing.md renamed to portal/contributing.md

@@ -1,4 +1,4 @@
-# Project Pythia Contributor's Guide
+# Contributing to Project Pythia
 
 ```{note}
 This the top-level guide for Project Pythia and a great starting point for getting involved!
@@ -10,16 +10,15 @@ and [contributing new Cookbooks](https://projectpythia.org/cookbook-guide.html).
 
 ## Overview
 
-Welcome! This is the main contributors guide for Project Pythia.
+Welcome! This is the main guide for contributing to Project Pythia.
 Project Pythia is an open community, and all contributions are
 welcome following our [Code of
 Conduct](https://projectpythia.org/code_of_conduct.html). All
 of the content for Project Pythia is hosted on GitHub in a number
 of different public repositories. From this document you can learn
 about the many ways that you can contribute to this community
 project, and where you can find additional information. In many
-cases pertinent details may be found in repository-specific
-contributors guides **that should always be consulted in addition
+cases pertinent details may be found in repository-specific guides **that should always be consulted in addition
 to this guide**. More on this topic later.
 
 ## The many ways to contribute
@@ -72,7 +71,7 @@ is a collection of material that the Pythia team believes is essential
 knowledge for geoscientists to effectively use the Scientific Python
 Ecosystem. The Pythia Foundations content is hosted on a separate
 [GitHub repo](https://github.com/ProjectPythia/pythia-foundations),
-and contributors should consult the contributor’s guide there for
+and contributors should consult the [Contributing to Foundations](https://foundations.projectpythia.org/appendix/how-to-contribute) guide there for
 information specific to Foundations. However, adding new, or changing
 existing Foundations content requires contributors to be familiar
 with a few technologies and workflows, described in Advanced
@@ -88,7 +87,7 @@ specific problem. Typically, a cookbook references material presented
 elsewhere in Project Pythia, such as [Pythia Foundations](https://foundations.projectpythia.org).
 Each Cookbook is hosted in a separate GitHub repo under the umbrella [Project Pythia
 organization](https://github.com/ProjectPythia).
-Contributors should consult the [Cookbook-specific Contributor's guide](/cookbook-guide).
+Contributors should consult the [Contributing a New Cookbook](/cookbook-guide) guide.
 
 ### Pythia Portal
 
@@ -114,10 +113,10 @@ process of setting up GitHub/Git, installing and configuring conda,
 and submitting a PR. Note, while this information is common to all
 Pythia repositories, repo-specific information might be required.
 
-In all cases contributors should consult the repo-specific contributor’s
+In all cases contributors should consult the repo-specific contribution
 guide for their target repository.
 
-Repo-specific guides can be found in the file named `CONTRIBUTING.md`, located in the top level directory of each repository, or by clicking on the menu item labeled “Contributor’s Guide” found in the rendered content generated by each repository.
+Repo-specific guides can be found in the file named `CONTRIBUTING.md`, located in the top level directory of most repositories, or by clicking on the appropriately named menu item on each site. Note that the "Contributing a new Cookbook" guide is found in the Pythia portal (rather than in any one specific Cookbook).
 
 Lastly, much of this information has been co-opted from the [GeoCAT project](https://geocat.ucar.edu).
 
@@ -221,12 +220,12 @@ desktop or laptop. Before using your conda environment to work on
 Pythia content, you'll need to perform an addtional one-time setup
 that is specific to each Pythia repo. After the one-time configuration is
 complete you will need to "activate" a repo-specific environment whenever
-you wish to use it. Consult the repo-specific contributor’s guide
+you wish to use it. Consult the repo-specific contribution guide
 for information on “Building the site”, and
 follow the steps described therein.
 
 ```{note}
-Repository-specific contributor's
+Repository-specific contribution
 information can always be accessed by navigating your web browser
 to the appropriate Project Pythia GitHub repository,
 [here](https://github.com/ProjectPythia/pythia-foundations) for
@@ -337,7 +336,7 @@ back to the Pythia repository you will need to submit a Pull Request
 ### Make your local changes
 
 At this point you should be able to make your desired changes to
-the local copies of your files. **Always consult the repo-specific contributor’s
+the local copies of your files. **Always consult the repo-specific contribution
 guide for information specific to the repo you are working on.**
 
 ### Submit a Pull Request (PR)