Skip to content

Contributing

Steven Clontz edited this page Jul 25, 2023 · 8 revisions

You'll need to log in or join GitHub to contribute.

Discussions

Not sure where to begin? Head over to our Discussion board and start a new thread! We're always happy to have new community members join the conversation.

Here is the thread for discussing these guidelines in particular.

Opening an Issue

If you have a specific improvement you'd like to see made to the pi-Base, you can always open an Issue that includes the following information:

  • All spaces/properties/theorems related to your improvement, including their IDs (e.g. S012345). Links to https://topology.pi-base.org are encouraged.
  • A description of the changes you'd recommend.

After discussion of your suggestion, any contributor can make a "Pull Request" (see below) to implement your improvement.

Make a Pull Request

To add a pull request implementing any changes to the repository, fork this project to your own account, which creates a copy of https://github.com/pi-base/data/ to something like https://github.com/StevenClontz/pibase-data/.

The easiest way to edit your fork of the repository is to use GitHub.dev. For example, if your fork is located at https://github.com/StevenClontz/pibase-data, you can either edit the URL to say https://github.dev/StevenClontz/pibase-data (note the .dev), or press the period key on your physical keyboard while viewing the repository to be redirected automatically. This opens a file editor in your web browser where you can make whatever changes you'd like. Then you can "commit & push" those changes to your fork.

image

When editing, be sure to review our conventions on notation and naming, and read below on information about references, our review criteria, etc.

Once you're happy with your changes, you can open up all pull request for review. Then one of our volunteer reviewers will check your work and discuss the proposed changes and any required effort necessary before they can be merged into the main data repository.

References

Contributions should generally reference a peer-reviewed publication, along with a Mathematical Reviews link or DOI link. Sometimes Wikipedia references are also appropriate.

pi-Base is not a forum for peer review, so to contribute improvements not directly reflected in the literature, we encourage you to ask (and self-answer if necessary) an appropriate question on either https://math.stackexchange.com/ or https://mathoverflow.net/, and use that as your citation.

Reviewers

These are our current reviewers. Please feel free to contact us with any questions via our Discussion board.

  • Chris Caruvana, @ccaruvana
  • Steven Clontz, @StevenClontz
  • Patrick Rabau, @prabau
  • Lynne Yengulalp, @lyengulalp

Info for reviewers is at this page.

Licensing

The copyright of all data in this repository - including any merged user contributions - is owned by Steven Clontz and James Dabbs and licensed for free public use under CC-BY-4.0. Please see LICENSE.md for details.