Contribute

Thanks for your interest in our contributing methods. We coordinate our work using Heptapod (a GitLab fork) and few other communication channels.

There are different ways to contribute to the project. For example, with just a browser, one can discuss or propose ideas on our communication channels, create issues on our Gitlab projects (see https://foss.heptapod.net/py-edu-fr) or even submit merge requests via the web interface (see Heptapod and Mercurial).

However, at some points, it will be more convenient to install locally few development tools, get the source locally, modify them and submit some changes.

What about this uncommon choice of Mercurial?

I (Pierre Augier) think than modern Mercurial with Heptapod can be a good technical choice for this project, offering a very nice developer experience. Moreover, using Mercurial for this project would tend to increase the diversity in terms of versioning tools which is a good thing considering the current situation of Git monopoly.

Currently, we are experimenting with using Mercurial instead of Git, with a very nice and easy versioning workflow. However, since most potential developers are used to Git, it represents a technical barrier for contribution. We try to make this barrier as small as possible by providing good documentation on contributing with Heptapod and Mercurial.

Important

A bit afraid of Mercurial? Don’t worry, our workflow is very simple and should not lead to any issues for most potential contributors, used to Git or not. However, don’t try to guess and spend 5 minutes to read our page on Heptapod and Mercurial.

• Communication channels
• Development tools
• Heptapod and Mercurial
  • Get the developer or maintainer role
  • Contribute via the web interface
  • Contribute with local development using Mercurial
• Websites and repositories
• Contribute to this website
  • Install and build locally
  • Minimal example
• Contribute to our books
  • Install and build locally
  • About Jupyter Book and notebooks saved in MySt Markdown
• Conventions d’écritures
  • Formatage
  • Typographie pour les documents en français
  • Annotations de difficulté
  • Textes
  • Terminologie
  • Transitions et navigation
  • Accessibilité et portabilité
  • Code
  • Méta informations
  • Encarts
  • Exercices
  • Solutions; version étudiant versus version instructeur
  • Exercices Jupylates

Our repositories are hosted on https://foss.heptapod.net/py-edu-fr. Thanks to CloudCrane, Octobus and Clever Cloud for providing foss.heptapod.net!