Release version 1.0.0

🎉 First stable release with comprehensive test coverage and CI/CD

- 57 tests covering all functionality
- CI/CD workflows for testing and linting
- Enhanced PyPI classifiers
- Production/Stable development status

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: 2 people

CHANGELOG.md

@@ -1,6 +1,8 @@
 # Changelog
 
-## Unreleased
+## Version 1.0.0 (2025-11-13)
+
+🎉 **First stable release!** Microdocs is now production-ready with comprehensive test coverage, CI/CD workflows, and a stable API.
 
 ### Added
 
@@ -18,6 +20,21 @@
   - Comprehensive testing documentation in CLAUDE.md
 - **README badges** - Added PyPI version, test status, Python version support, and license badges
 
+### Changed
+
+- **Development status** upgraded from Beta to Production/Stable
+- **Enhanced PyPI classifiers** with better categorization for documentation and text processing
+
+### Deployment
+
+```bash
+# Using uv (recommended)
+uvx microdocs@1.0 README.md CHANGELOG.md
+
+# Using pip
+pip install --upgrade microdocs
+```
+
 ## Version 0.3.0 (2025-11-13)
 
 ### Added

CLAUDE.md

@@ -86,6 +86,58 @@ pytest --cov=microdocs
 - `.github/workflows/test.yml` - Runs tests on Python 3.11, 3.12, 3.13, 3.14
 - `.github/workflows/lint.yml` - Runs ruff check and ruff format --check
 
+### Release Process
+
+When creating a new release, follow these steps **in order**:
+
+1. **Run full test suite** - Verify everything passes before releasing
+   ```bash
+   pytest && ruff check . && ruff format --check .
+   ```
+
+2. **Update version** in `pyproject.toml`
+   - Bump version number
+   - Update development status classifier if needed (Alpha → Beta → Production/Stable)
+
+3. **Update CHANGELOG.md**
+   - Move "Unreleased" section to new version heading with date
+   - Add summary of changes (Added, Changed, Fixed, etc.)
+   - Include deployment instructions with new version number
+
+4. **Commit changes**
+   ```bash
+   git add pyproject.toml CHANGELOG.md
+   git commit -m "Release version X.Y.Z"
+   ```
+
+5. **Create git tag**
+   ```bash
+   git tag -a vX.Y.Z -m "Release vX.Y.Z: brief description"
+   ```
+
+6. **Build the package**
+   ```bash
+   uv build
+   ```
+
+7. **Publish to PyPI**
+   ```bash
+   uv publish
+   ```
+
+8. **Push changes and tags**
+   ```bash
+   git push
+   git push --tags
+   ```
+
+**Important Notes:**
+- Always run tests BEFORE building and publishing
+- Never build before creating git commit and tag
+- Always create git tag BEFORE building
+- Update CHANGELOG with actual release date
+- Include deployment instructions in CHANGELOG
+
 ## Architecture
 
 ### Core Components

pyproject.toml

@@ -4,15 +4,15 @@ build-backend = "hatchling.build"
 
 [project]
 name = "microdocs"
-version = "0.3"
+version = "1.0"
 description = "Transform your Markdown files into a self-contained HTML documentation site."
 readme = "README.md"
 authors = [
     { name = "Martin Mahner", email = "martin@mahner.org" }
 ]
 license = "MIT"
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
     "Environment :: Web Environment",
     "Intended Audience :: Developers",