Skip to content

refactor(aggregation): remove docs/projects/ mirror layer and dead config#100

Merged
yeoldegrove merged 1 commit into
mainfrom
feat/aggregator_cleanup
Jul 2, 2026
Merged

refactor(aggregation): remove docs/projects/ mirror layer and dead config#100
yeoldegrove merged 1 commit into
mainfrom
feat/aggregator_cleanup

Conversation

@yeoldegrove

@yeoldegrove yeoldegrove commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

What this PR does / why we need it:

The aggregation pipeline previously mirrored fetched docs into
docs/projects// via target_path, transform_directory_structure,
and /projects/-scoped link rewrites. These were never the canonical
output path for VitePress; removing them simplifies the pipeline to a
single copy step.

Removed:

  • target_path field from RepoConfig, repos-config.json, and
    repos-config.local.json
  • transform_directory_structure() (mirror step) and
    fix_broken_project_links()
  • base_path="/projects" parameter and all /projects/-prefixed link
    rewrites from rewrite_links()
  • docs/projects from .gitignore, Makefile clean, sidebar
    excludePattern, and ignoreDeadLinks
  • Project Mirrors section from contributing docs

Dead config eliminated alongside:

  • special_files (was always {} in every repo entry)
  • dict-style structure (was an identity map for gardenlinux; replaced
    by the existing "flat" default)
  • unused media_dirs parameter from transform_directory_structure()
  • ./same-dir, bare-filename, inside-docs ../, and numbered-prefix link
    rewrites (VitePress resolves these natively)

Hardened and simplified:

  • RepoConfig.from_dict() now raises ValueError for non-string structure
    values
  • from_dict() gains sensible defaults: docs_path="docs",
    media_directories=[".media", "assets"]
  • save_config() omits fields at their default values

@yeoldegrove yeoldegrove added this to the 2026-07 milestone Jul 2, 2026
@yeoldegrove yeoldegrove self-assigned this Jul 2, 2026
@netlify

netlify Bot commented Jul 2, 2026

Copy link
Copy Markdown

Deploy Preview for gardenlinux-docs ready!

Name Link
🔨 Latest commit e7c6a83
🔍 Latest deploy log https://app.netlify.com/projects/gardenlinux-docs/deploys/6a46840f476c80000815e811
😎 Deploy Preview https://deploy-preview-100--gardenlinux-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@yeoldegrove yeoldegrove changed the title refactor(aggregation): remove dict-structure, special_files, and redundant link rewrites refactor(aggregation): remove docs/projects/ mirror layer and dead config Jul 2, 2026
…nfig

The aggregation pipeline previously mirrored fetched docs into
docs/projects/<repo>/ via target_path, transform_directory_structure,
and /projects/-scoped link rewrites.  These were never the canonical
output path for VitePress; removing them simplifies the pipeline to a
single copy step.

Removed:
- target_path field from RepoConfig, repos-config.json, and
  repos-config.local.json
- transform_directory_structure() (mirror step) and
  fix_broken_project_links()
- base_path="/projects" parameter and all /projects/-prefixed link
  rewrites from rewrite_links()
- docs/projects from .gitignore, Makefile clean, sidebar
  excludePattern, and ignoreDeadLinks
- Project Mirrors section from contributing docs

Dead config eliminated alongside:
- special_files (was always {} in every repo entry)
- dict-style structure (was an identity map for gardenlinux; replaced
  by the existing "flat" default)
- unused media_dirs parameter from transform_directory_structure()
- ./same-dir, bare-filename, inside-docs ../, and numbered-prefix link
  rewrites (VitePress resolves these natively)

Hardened and simplified:
- RepoConfig.from_dict() now raises ValueError for non-string structure
  values
- from_dict() gains sensible defaults: docs_path="docs",
  media_directories=[".media", "assets"]
- save_config() omits fields at their default values

Signed-off-by: Eike Waldt <waldt@b1-systems.de>
On-behalf-of: SAP <eike.waldt@sap.com>
Assisted-by: Kilo:claude-opus-4-7
Assisted-by: Kilo:claude-sonnet-4-6
@yeoldegrove yeoldegrove force-pushed the feat/aggregator_cleanup branch from ea06337 to e7c6a83 Compare July 2, 2026 15:30
@yeoldegrove yeoldegrove marked this pull request as ready for review July 2, 2026 15:32
@yeoldegrove yeoldegrove merged commit b128f75 into main Jul 2, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant