Commit graph

166 commits

Author SHA1 Message Date
1c462af51b fix: ensure package-lock.json is included in Docker build context
npm ci requires package-lock.json to be present in the build context.
Explicitly allow package-lock.json in .dockerignore to fix CI build failure.
2025-10-23 17:15:14 +02:00
fb4ecf6df4 chore: remove generated Hugo resources from repository
Remove auto-generated Hugo image files from resources/_gen/.
These files are build artifacts and should not be version controlled
(already listed in .gitignore but were previously committed).
2025-10-23 17:07:35 +02:00
4294524e81 feat(ci): add Docker build pipeline with version management
- Add multi-stage Dockerfile with pinned tool versions (Node 24.10.0, Go 1.25.1, Hugo 0.151.0)
- Create .env.versions as single source of truth for all tool versions
- Add GitHub Actions CI workflow for automated OCI image builds
  - Multi-arch support (amd64, arm64)
  - Automatic version loading from .env.versions
  - Docker registry push with metadata tags
- Add Taskfile tasks for local OCI image building and testing
  - task build:oci-image - Build with version-pinned dependencies
  - task test:oci-image - Build and test container locally
- Pin devbox.json to specific versions matching .env.versions
- Add comprehensive documentation (DOCKER.md, VERSIONS.md)
- Add helper script (scripts/get-versions.sh) for version extraction

This enables consistent development and production environments with
identical tool versions across local devbox, Docker builds, and CI/CD.
2025-10-23 17:04:28 +02:00
8e0aea2893 feat(theme): improve inline code styling with Telekom colors
- Style inline code blocks (backticks) with soft pink background
- Use Telekom magenta for code text color
- Add border-radius and padding for better readability
- Distinguish inline code from fenced code blocks
2025-10-23 15:43:37 +02:00
a1be93920d feat(theme): implement Telekom design system with magenta color scheme
- Add TeleNeo font family with all weights (300-700)
- Implement Telekom brand colors (magenta #E20074 as primary)
- Add dark mode support with inverted color palette
- Style navigation with soft hover states and active indicators
- Override Bootstrap/Docsy variables for consistent theming
- Fix deprecated Hugo template syntax for Disqus integration
- Apply Telekom-inspired styling to all UI components
2025-10-23 15:21:02 +02:00
43cbd69c9c refactor(docs): migrate existing content to v1 legacy structure
- Move all existing docs content (concepts, project, solution) to /docs/v1/
- Add legacy banner component to warn users about archived documentation
- Create v1 index page with legacy notice and redirect guidance
- Implement automatic banner display for all v1 paths
- Preserve all original content for reference during migration

This enables incremental content migration while maintaining access to
original documentation.
2025-10-23 14:54:08 +02:00
acbdf33fac chore: configure markdownlint VS Code extension
Install and configure markdownlint extension for in-editor linting with
visual feedback (squiggly lines, Problems panel, quick fixes).

Changes:
- Install davidanson.vscode-markdownlint extension
- Configure .vscode/settings.json to use .markdownlint.json
- Enable immediate visual feedback for markdown style issues

Benefits:
- Real-time markdown linting while editing
- Quick fixes via lightbulb (Ctrl+.)
- Problems panel integration (Ctrl+Shift+M)
- Consistent with CLI linting configuration
2025-10-23 14:30:35 +02:00
f797af114b test: configure comprehensive markdown linting with Docsy best practices
Configure markdownlint with rules aligned to technical documentation
standards and Docsy theme conventions.

Design Decisions:
- Enable core quality rules (heading hierarchy, consistent list styles)
- Allow inline HTML for Docsy shortcodes and components
- Permit bare URLs (common in technical documentation)
- Make code block language hints optional (pragmatic for existing content)
- Set maximum 2 consecutive blank lines (balanced readability)
- Enforce single trailing newline (POSIX standard)
- Use asterisk for unordered lists (consistency)
- Allow 2-space list indentation (Markdown standard)

Auto-fixed Issues:
- Converted dash lists to asterisk lists (568 fixes)
- Removed trailing spaces (211 fixes)
- Added missing trailing newlines (74 fixes)
- Added blank lines around lists and headings (100+ fixes)

Remaining Style Warnings (intentionally accepted):
- MD029: List numbering variations in meeting notes (75 instances)
- MD036: Bold text for section headers in ADRs (13 instances)
- MD025: Multiple H1 in notes/brainstorming docs (10 instances)
- MD032/MD022: Minor spacing variations (15 instances)

Test Results:
 Hugo build: 227 pages generated successfully
 HTML validation: No errors
 Link checking: All links valid (except dev-only livereload)
 Markdown linting: Only non-critical style warnings remain

The configuration balances strict quality checks with pragmatic
flexibility for diverse content types (documentation, ADRs, meeting
notes, tutorials).
2025-10-23 14:25:46 +02:00
3eaa574a26 docs(dev): add Taskfile and developer documentation
- Add Taskfile.yml with common development tasks
- Add go-task to devbox dependencies
- Create comprehensive README-developer.md covering:
  - Devbox setup and usage
  - Hugo and Docsy basics
  - Task commands reference
  - Development workflow
  - Content creation guide
  - Testing procedures
  - Troubleshooting tips
2025-10-23 14:13:31 +02:00
08a0e8863f chore(config): improve .gitignore for Hugo project
- Add resources/_gen/ for Hugo-generated assets
- Add node_modules/ for NPM dependencies
- Add test output directories (tmp/, .htmltest/)
- Add devbox local directory (.devbox/)
- Add IDE files (VS Code, IntelliJ, Vim)
- Add OS-specific files (macOS, Windows)
- Add log files
- Remove package.json from ignore (needed for NPM scripts)
2025-10-23 14:02:54 +02:00
12e31ede91 test: add comprehensive testing infrastructure
- Add npm test scripts for build, markdown, HTML, and link validation
- Install markdownlint-cli for content quality checks
- Install html-validate for HTML5 conformity validation
- Add htmltest (via devbox) for internal/external link checking
- Configure test rules in .htmltest.yml, .htmlvalidate.json, .markdownlint.json
- Add GitHub Actions workflow for automated CI testing
- Add TESTING.md documentation for test usage
2025-10-23 14:02:39 +02:00
d6f3d67724 chore(deps): update Hugo to v0.151.0 and Docsy to v0.12.0
- Upgrade Hugo from v0.125.4 to v0.151.0+extended
- Upgrade Docsy theme from v0.10.0 to v0.12.0
- Update Bootstrap to v5.3.8
- Update Go to v1.25.1
- Add Node.js for PostCSS support
- Install PostCSS, autoprefixer dependencies
- Remove obsolete custom render-heading template
- Update minimum Hugo version requirement to 0.151.0
2025-10-23 14:02:22 +02:00
Bot
ceb213cf64 doc(work-structure): MVP1-12-OTC kickoff planning 2025-04-29 15:23:37 +02:00
Bot
1bbedec64a ex post: review minutes 01.04.25 2025-04-29 15:21:31 +02:00
fa1e343247 doc(arch): minutes of a robert-stephan talk about crossplane vs terraform 2025-03-31 09:58:40 +02:00
2949d154f9 chore(architecture): minutes of several meetings in the new-architecture agenda 2025-02-25 16:32:30 +01:00
908f2c1c93 doc(concepts): building blocks of platforms recommended by John Dietz, CEO of Konstruct 2025-01-23 15:44:55 +01:00
860d61c2f4 Merge remote-tracking branch 'refs/remotes/ipceicis/pipeline-adr' into pipeline-adr 2024-12-19 11:02:35 +01:00
Kai Reichart
4d8e1c8938 updated adr 2024-12-19 10:28:28 +01:00
Kai Reichart
92cd525ea9 added ADR for pipelines 2024-12-19 10:28:28 +01:00
311269eb39 Merge branch 'development' 2024-12-19 10:04:45 +01:00
9e6d42ffb0 Update _index.md
more details for dashboards, nginx
2024-12-13 15:02:20 +01:00
7ab69e9139 fix(): typo 2024-12-11 15:05:15 +01:00
8599ddbefc Telemetry Use Case
added Telemetry Use Case showing Fibonacci workload
2024-12-05 14:27:02 +01:00
662d26581c feat(architecture): WiP ... just a notice on the outcome of today's arch session 2024-12-04 14:48:53 +01:00
58da741bca doc(architecture): added architectural decision of templated stacks 2024-12-04 14:36:59 +01:00
1b77a80563 Merge remote-tracking branch 'refs/remotes/ipceicis-dev/main' 2024-11-29 09:00:58 +01:00
e0dce8ef46 deploy kube-prometheus (2) 2024-11-28 15:23:40 +01:00
0b7a85575e deploy kube-prometheus 2024-11-28 15:18:10 +01:00
a8bf2ae252 fix(pos-structure): addid cahrts, refactored 2024-11-27 11:13:36 +01:00
6b37c0b08a feat(poc-structure): added high level design of poc output 2024-11-26 16:50:01 +01:00
9ec0ae1ca9 Merge branch 'development' into feature/IPCEICIS-724-work-out-concept-for-repository-process-and-structure-especially-poc 2024-11-26 16:36:16 +01:00
b377a35439 doc(stakeholder-workshop): finalized documentation 2024-11-25 15:41:23 +01:00
4ca5829b90 Merge branch 'development' into stakeholder-workshop 2024-11-25 14:44:29 +01:00
741563c236 feat(team-process): IPCEICIS-724, WiP, to be discussed in arch session 2024-11-19 13:24:17 +01:00
73b4a5030c fix() 2024-11-19 09:51:32 +01:00
bd4672c103 WiP 2024-11-18 22:37:37 +01:00
Kai Reichart
423d90e02b updated adr 2024-11-18 16:07:50 +01:00
206f67d33c WiP check if confluence gets this included 2024-11-18 16:04:48 +01:00
b545fff0be Added documentation for how to publish provider-kind in a custom docker registry 2024-11-14 14:59:56 +01:00
Kai Reichart
92b0de8957 added ADR for pipelines 2024-11-13 09:30:25 +01:00
04954fcb04 Added documentation for crossplane provider-kind 2024-11-13 09:05:04 +01:00
florian.fuerstenberg
190dd86205 Merge pull request 'feat(cicd): general concept' (#7) from feature/cicd-concept into main
Reviewed-on: https://forgejo.edf-bootstrap.cx.fg1.ffm.osc.live/DevFW/website-and-documentation/pulls/7
Reviewed-by: kai.reichart <kai.reichart@t-systems.com>
2024-11-11 16:22:00 +00:00
kai.reichart
805bb5de09 Merge branch 'main' into feature/cicd-concept 2024-11-11 12:46:57 +00:00
6fc585e7c2 Merge pull request 'idpbuilder-backstage-templates' (#15) from idpbuilder-backstage-templates into development
Reviewed-on: https://forgejo.edf-bootstrap.cx.fg1.ffm.osc.live/DevFW/website-and-documentation/pulls/15
2024-11-08 13:03:21 +00:00
923c2f87c0 refactor(included-backstage-templates): chapter moved to CNOE as it's not idpbuilder related 2024-11-08 14:02:39 +01:00
a68629559d Merge branch 'development' into idpbuilder-backstage-templates 2024-11-08 13:55:44 +01:00
3f2bbdaf48 Merge pull request 'feat(cnoe-argocd): Overview of argocd and general description of its role in CNOE' (#14) from cnoe-argocd into main
Reviewed-on: https://forgejo.edf-bootstrap.cx.fg1.ffm.osc.live/DevFW/website-and-documentation/pulls/14
2024-11-08 12:36:27 +00:00
68cf4359b0 Merge branch 'development' into cnoe-argocd 2024-11-08 13:32:47 +01:00
340b5d02e0 Merge pull request 'docs(routing): more general information on http-routing' (#13) from routing-excerpt into main
Reviewed-on: https://forgejo.edf-bootstrap.cx.fg1.ffm.osc.live/DevFW/website-and-documentation/pulls/13
2024-11-08 12:30:31 +00:00