feat: Setup repository for handbook v2.0.0alpha release with documentation improvements

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased](https://github.com/maehr/diskriminierungsfreie-metadaten/compare/v1.0.1...HEAD)
 
+## [v2.0.0-alpha.0] - TBD
+
+### Repository Setup
+
+- Created v2.0.0alpha branch for handbook v2.0.0alpha development
+- Updated versioning strategy to support semantic versioning with alpha releases
+- Enhanced contribution guidelines with v2.0.0alpha development workflow
+- Configured git-cliff for pre-release version support
+- Established foundation for handbook restructuring and content development
+
 ## [v1.0.1](https://github.com/maehr/diskriminierungsfreie-metadaten/releases/tag/v1.0.1) - 2025-01-23
 
 ### Features

CONTRIBUTING.md

@@ -41,6 +41,42 @@ node scripts/fetch-latest-doi.js
 
 This ensures that all documentation and citations reference the correct published version and date consistently across all files.
 
+## v2.0.0alpha Development Guidelines
+
+The v2.0.0alpha release represents a major overhaul of the _Diskriminierungsfreie Metadaten_ handbook. Development for this release follows specific guidelines:
+
+### Branch Strategy
+
+- **Main branch**: Stable v1.x releases and maintenance
+- **v2.0.0alpha branch**: Active development for v2.0.0alpha release
+- **Feature branches**: Create from `v2.0.0alpha` for specific features, prefix with `v2/feature/`
+
+### Alpha Release Versioning
+
+This release follows semantic versioning with alpha pre-release identifiers:
+
+- **v2.0.0-alpha.0**: Initial alpha release setup
+- **v2.0.0-alpha.1, v2.0.0-alpha.2, etc.**: Iterative alpha releases
+- **v2.0.0-beta.0**: Beta release when alpha phase is complete
+- **v2.0.0**: Final release
+
+### Development Workflow for v2.0.0alpha
+
+1. **Base branch**: All v2 work should be based on the `v2.0.0alpha` branch
+2. **Feature development**: Create feature branches from `v2.0.0alpha`
+3. **Pull requests**: Target the `v2.0.0alpha` branch, not `main`
+4. **Testing**: Ensure all changes work with the existing build pipeline
+5. **Documentation**: Update relevant documentation as part of feature development
+
+### Alpha Release Goals
+
+The v2.0.0alpha release aims to establish:
+
+- Restructured repository organization
+- Enhanced build pipeline for the new handbook structure
+- Updated documentation framework
+- Foundation for content development and review
+
 ## Pull Request Process
 
 1. Ensure any install or build dependencies are removed before the end of the layer when doing a

cliff.toml

@@ -59,10 +59,10 @@ commit_parsers = [
 protect_breaking_commits = false
 # filter out the commits that are not matched by commit parsers
 filter_commits = false
-# glob pattern for matching git tags
+# glob pattern for matching git tags (including pre-release versions)
 tag_pattern = "v[0-9]*"
 # regex for skipping tags
-skip_tags = "v0.1.0-beta.1"
+skip_tags = ""
 # regex for ignoring tags
 ignore_tags = ""
 # sort the tags topologically

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "diskriminierungsfreie-metadaten",
-	"version": "1.0.1",
+	"version": "2.0.0-alpha.0",
 	"description": "Handbuch zur Erstellung diskriminierungsfreier Metadaten für historische Quellen und Forschungsdaten. Erfahrungen aus dem geschichtswissenschaftlichen Forschungsprojekt Stadt.Geschichte.Basel",
 	"author": "Moritz Mähr <[email protected]>",
 	"url": "https://github.com/maehr/diskriminierungsfreie-metadaten/issues",