Skip to content
Daniel Peter edited this page Nov 21, 2022 · 42 revisions

Development wiki

Welcome to the development wiki of SPECFEM3D. The goal of this page is to provide instructions and best practices to guide developers and contributing scientists. It is intended as a developer reference, not as a replacement for the user manual.

SPECFEM3D code

Contributing topics

  • Best Practices: Accepted conventions for SPECFEM development are described here. To create a product that is maintainable over the long term, it is important that contributing scientists follow these conventions.

  • Using Git for SPECFEM: The standard way of contributing to SPECFEM development is described here. This approach is recommended for most users, especially those not familiar with Git. These instructions are adequate for contributing to SPECFEM, but we recommend that all new users to Git attempt the Software Carpentry tutorial mentioned below for more complete understanding of the workflow.

  • Advanced Git Topics: Alternative procedures for contributing to SPECFEM are described here, along with advanced aspects of Git and GitHub. MOST USERS CAN SAFELY IGNORE THIS SECTION.

  • Versioning Conventions: The conventions behind SPECFEM's version numbering system are explained here.

  • Merging Development Branches into Master: Mostly intended for maintainers of the code repository on how to merge the devel branch version into the main master branch for a new code release.

More Git informations from external pages:

  • Software Carpentry Git Tutorial: For those who are not familiar with Git, we recommend attempting this tutorial, or even better, attending an in-person tutorial session if available in your area.

SPECFEM3D

Clone this wiki locally