Proposal: Add Version Tags to DynEarthSol Commit History #38
Description
I propose adding semantic version tags to DynEarthSol's commit history to make releases more discoverable and improve citation practices. This will help users identify stable versions and understand the evolution of major features. However, I am not sure the actual development history before 2020. Please free provide milestone with version hash. I am also wondering if the minor version tag is needed before 2020. @GeoFLAC/des
Motivation
Currently, DynEarthSol lacks version tags in the repository, making it difficult for users to:
- Identify which commits correspond to stable releases
- Cite specific versions in scientific publications
- Track the introduction of major features
- Understand the software's evolution over time
Proposed Version Scheme
Two-level semantic versioning: v1.X.Y
MAJOR versions (v1.X.0) - Citation-worthy features
New physics capabilities or game-changing technical improvements that fundamentally change what DynEarthSol can do scientifically.
PATCH versions (v1.x.Y) - Incremental updates
Minor features, refinements, bug fixes, and infrastructure improvements.
Proposed Version Timeline
MAJOR Releases (10 versions)
| Version | Date | Commit | Feature |
|---|---|---|---|
| v1.0.0 | 2012-11-06 | dc3ead7 | First dynamic geodynamic model |
| v1.1.0 | 2012-11-09 | 2bf75ad | Elasto-plastic rheology |
| v1.2.0 | 2013-06-25 | 2e28fc2 | Markerset system for material tracking |
| v1.3.0 | 2014-05-22 | fe60c9c | FLAC plane strain formulation |
| v1.4.0 | 2020-07-01 | 1e8be59 | MMG adaptive remeshing |
| v1.5.0 | 2020-10-29 | c159c38 | Surface marker correction system |
| v1.6.0 | 2025-04-08 | 3e2d44c | Regular mesh for 3D |
| v1.7.0 | 2025-04-16 | 0ea3899 | Rate-and-state friction model |
| v1.8.0 | 2025-08-28 | bfb4840 | GPU acceleration |
| v1.9.0 | 2025-11-02 | 7e87b30 | VTK-HDF output format |
PATCH Releases (20 versions)
Click to expand full patch version list
| Version | Date | Commit | Feature |
|---|---|---|---|
| v1.0.1 | 2012-11-07 | d4cf665 | Basic rheologies (Maxwell, elastic) |
| v1.1.1 | 2012-12-06 | 2bf8067 | Plastic parameters configuration |
| v1.1.2 | 2013-01-11 | aa2d98c | 2D plasticity formulation |
| v1.2.1 | 2013-12-20 | 09ffa0f | Surface processes and quasi-static mode |
| v1.3.1 | 2014-11-21 | 137e247 | True plane strain implementation |
| v1.3.2 | 2015-02-25 | 6ef417b | Mesh optimization |
| v1.3.3 | 2016-11-18 | ba0d147 | Libadaptivity integration |
| v1.5.1 | 2021-05-10 | 035e506 | Surface correction improvement |
| v1.5.2 | 2021-12-02 | 4a06668 | Hackathon features |
| v1.5.3 | 2025-04-07 | c1b06ab | Surface process fixes |
| v1.6.1 | 2025-04-08 | c199c9e | Memory leak fix |
| v1.6.2 | 2025-04-08 | 767fba0 | Mesh refinements |
| v1.6.3 | 2025-04-08 | a665930 | Regular mesh fixes |
| v1.7.1 | 2025-04-24 | f00101c | Restart checkpoint fixes |
| v1.7.2 | 2025-08-05 | 3ace4ce | Rheology bug fix |
| v1.8.1 | 2025-10-17 | bc222c8 | Surface interpolation |
| v1.8.2 | 2025-10-17 | f1428a1 | Surface processing fixes |
| v1.8.3 | 2025-10-27 | 8aec7a3 | Compiler compatibility fixes |
| v1.8.4 | 2025-10-27 | 3795087 | Remeshing fixes |
| v1.9.1 | 2025-11-04 | 1691fb3 | Cross-platform compatibility |
| v1.9.2 | 2025-11-11 | 1034b18 | Output info display |