refactor(i18n): rename vorlagen/ -> templates/, *-vorlage -> *-template

Final German naming cleanup in dev-process:
- vorlagen/                            -> templates/
- vorlagen-word/                       -> templates-word/
- tools/generate_word_vorlagen.sh      -> tools/generate_word_templates.sh
- *-vorlage.md / *-vorlage.docx        -> *-template.md / *-template.docx
- Review-Protokoll-vorlage.*           -> Review-Minutes-template.*
- angebot-vorlage.*                    -> quote-template.*
- angebot-beispiel.html                -> quote-example.html

All references in README.md, toolstack/toolstack.md, build_word_template.py,
and generate_word_templates.sh updated. The master Word style template
(slohmaier-doc-template.docx) was already English-named.

The dev-process repo is now fully English in both content and structure.
This commit is contained in:
Stefan Lohmaier committed 2026-05-12 12:09:06 -07:00
1 parent cc1a2b8129
commit 247b8311f3
29 files changed
+25 -25

No files matched your search

+6 -6
View File
@@ -23,7 +23,7 @@ The two worlds — ISO-9001 audits vs day-to-day engineering — have different
| Code, tests, CI | source | obvious | | Code, tests, CI | source | obvious |
| Customer-facing PDFs | **PDF via pandoc** from MD | formal handover of engineering artifacts | | Customer-facing PDFs | **PDF via pandoc** from MD | formal handover of engineering artifacts |
**Markdown templates are the source of truth**; Word is built from them via pandoc (`tools/generate_word_vorlagen.sh`). **Markdown templates are the source of truth**; Word is built from them via pandoc (`tools/generate_word_templates.sh`).
## Monorepo structure ## Monorepo structure
@@ -128,7 +128,7 @@ links:
*/ */
``` ```
Templates: `vorlagen/SA-vorlage.md`, `vorlagen/SWA-vorlage.md`. Templates: `templates/SA-template.md`, `templates/SWA-template.md`.
## Reviews ## Reviews
@@ -177,17 +177,17 @@ Runs on every push and PR:
| `toolstack/toolstack.md` | Complete tool stack | | `toolstack/toolstack.md` | Complete tool stack |
| `gitea-aspice-setup.md` | Setting up Gitea for ASPICE | | `gitea-aspice-setup.md` | Setting up Gitea for ASPICE |
| `dev-process-schaubild.html` | V-model infographic | | `dev-process-schaubild.html` | V-model infographic |
| `vorlagen/` | Markdown templates (source of truth) | | `templates/` | Markdown templates (source of truth) |
| `vorlagen-word/` | Generated Word templates + master template `slohmaier-doc-template.docx` | | `templates-word/` | Generated Word templates + master template `slohmaier-doc-template.docx` |
| `tools/build_word_template.py` | Builds the neutral Word master template with styles, cover page, document control | | `tools/build_word_template.py` | Builds the neutral Word master template with styles, cover page, document control |
| `tools/generate_word_vorlagen.sh` | Builds the `.docx` versions from the `.md` templates via pandoc | | `tools/generate_word_templates.sh` | Builds the `.docx` versions from the `.md` templates via pandoc |
## Regenerate Word templates ## Regenerate Word templates
```bash ```bash
# Rebuild master template + all derived Word templates # Rebuild master template + all derived Word templates
python3 tools/build_word_template.py python3 tools/build_word_template.py
bash tools/generate_word_vorlagen.sh bash tools/generate_word_templates.sh
``` ```
The master template is ISO-9001-compliant and includes: The master template is ISO-9001-compliant and includes:
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
+2 -2
View File
@@ -2,7 +2,7 @@
""" """
Build the neutral slohmaier Word document template. Build the neutral slohmaier Word document template.
Output: vorlagen-word/slohmaier-doc-template.docx Output: templates-word/slohmaier-doc-template.docx
The template is ISO 9001 / ASPICE-friendly: The template is ISO 9001 / ASPICE-friendly:
- Cover page with project, doc-ID, version, classification - Cover page with project, doc-ID, version, classification
@@ -579,5 +579,5 @@ def build_template(out_path: Path):
if __name__ == "__main__": if __name__ == "__main__":
out = Path(sys.argv[1] if len(sys.argv) > 1 else out = Path(sys.argv[1] if len(sys.argv) > 1 else
Path(__file__).resolve().parent.parent / "vorlagen-word" / "slohmaier-doc-template.docx") Path(__file__).resolve().parent.parent / "templates-word" / "slohmaier-doc-template.docx")
build_template(out) build_template(out)
@@ -1,5 +1,5 @@
#!/usr/bin/env bash #!/usr/bin/env bash
# Convert the formal-document Markdown vorlagen to Word .docx # Convert the formal-document Markdown templates to Word .docx
# using slohmaier-doc-template.docx as style reference. # using slohmaier-doc-template.docx as style reference.
# #
# Word is the industry standard for formal release / ISO 9001 audits. # Word is the industry standard for formal release / ISO 9001 audits.
@@ -9,8 +9,8 @@
set -euo pipefail set -euo pipefail
REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)" REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
SRC="$REPO_ROOT/vorlagen" SRC="$REPO_ROOT/templates"
DST="$REPO_ROOT/vorlagen-word" DST="$REPO_ROOT/templates-word"
TEMPLATE="$DST/slohmaier-doc-template.docx" TEMPLATE="$DST/slohmaier-doc-template.docx"
if [[ ! -f "$TEMPLATE" ]]; then if [[ ! -f "$TEMPLATE" ]]; then
@@ -20,16 +20,16 @@ fi
# Formal documents (to Word): # Formal documents (to Word):
FORMAL_DOCS=( FORMAL_DOCS=(
PID-vorlage PID-template
PM-Plan-vorlage PM-Plan-template
QA-Plan-vorlage QA-Plan-template
SWE-Plan-vorlage SWE-Plan-template
Test-Plan-vorlage Test-Plan-template
Review-Protokoll-vorlage Review-Minutes-template
Non-Conformity-vorlage Non-Conformity-template
MISRA-Deviation-Permit-vorlage MISRA-Deviation-Permit-template
MISRA-Deviation-Record-vorlage MISRA-Deviation-Record-template
angebot-vorlage quote-template
) )
mkdir -p "$DST" mkdir -p "$DST"
+4 -4
View File
@@ -87,9 +87,9 @@ doorstop check # bidirectional, fails on gaps
doorstop publish all docs/traceability/ # generate traceability matrix doorstop publish all docs/traceability/ # generate traceability matrix
``` ```
Templates under `dev-process/vorlagen/`: Templates under `dev-process/templates/`:
- `SA-vorlage.md` — System Architecture Element - `SA-template.md` — System Architecture Element
- `SWA-vorlage.md` — Software Architecture Element - `SWA-template.md` — Software Architecture Element
SWD is only mandatory for ASIL-C/D; for QM/A/B, code + header comments are sufficient. SWD is only mandatory for ASIL-C/D; for QM/A/B, code + header comments are sufficient.
@@ -114,7 +114,7 @@ Cppcheck with the MISRA addon checks C code for MISRA compliance. Free, runs in
cppcheck --addon=misra --error-exitcode=1 src/ cppcheck --addon=misra --error-exitcode=1 src/
``` ```
Deviation permits and records are kept as Markdown files in the `misra/` directory. Templates under `dev-process/vorlagen/`. Deviation permits and records are kept as Markdown files in the `misra/` directory. Templates under `dev-process/templates/`.
--- ---