Skip to content

docs(posts): reflect the cloud-native-ref refactor in past-year posts (EN/FR) - #110

Merged
Smana merged 2 commits into
mainfrom
docs/cloud-native-ref-refactor-links
Aug 28, 2026
Merged

Smana merged 2 commits into
mainfrom
docs/cloud-native-ref-refactor-links

Conversation

@Smana

@Smana Smana commented Aug 28, 2026

Copy link
Copy Markdown
Owner

What

cloud-native-ref now has its own documentation site (cnref.ogenki.io) and the Crossplane compositions were extracted into a dedicated repo (Smana/crossplane-configuration). This updates the six posts from the past year (EN + FR) so their links and descriptions match the current state of the project.

Changes

  • cnref.ogenki.io is now the primary link when referring to the project; the GitHub repo is demoted to a secondary "source on GitHub" link.
  • Crossplane composition links point to Smana/crossplane-configuration (apis/<name>/kcl layout, ghcr.io/smana/crossplane-configuration-* packages) instead of the old infrastructure/base/crossplane/configuration/kcl/... paths.
  • AWS EKS + GCP GKE is mentioned wherever the platform is described (it used to say "EKS" only).
  • Dead links replaced:
    • docs/llm-platform-future-paths.mdAI platform roadmap
    • docs/postgresql-monitoring-architecture.mddocs page
    • docs/decisions/ADRs on the docs site
    • CLAUDE.md mentions now deep-link to the file itself
    • dropped the stale #L62-L338 anchor on the Vector config link

Posts touched (EN + FR in parity)

Post Series
ai-coding-agent Agentic AI
ai-coding-tips Agentic AI
llm-self-hosted-stack Agentic AI
logs Observability
postgresql Observability
runlore Observability

Verification

  • All 19 github.com/Smana/* and cnref.ogenki.io links in the touched files return 200.
  • ghcr.io/smana/crossplane-configuration-aws:v0.4.1 confirmed present in the registry (latest tag).
  • apis/inferenceservice/kcl/main_test.k, apis/sqlinstance, apis/app confirmed in the crossplane-configuration tree.
  • hugo --minify builds clean.

Follow-up commit: crossplane_composition_functions (2023-12-23)

Same rot, older post. Its captions link to files that were rewritten in KCL and moved out of the repo, so 5 of the 8 source links 404'd — and the 2 that still resolved had drifted away from the snippets shown in the post (environmentconfig.yaml is now v1beta1 with a cloud: key; the post quotes v1alpha1 without it).

Pointing these at the current KCL compositions would break the caption↔snippet contract — the code would look nothing like what the post shows. So they're pinned to 3d095df, the commit from the day before publication, where all five paths exist with content matching the quoted blocks exactly (#L150 still lands precisely on the transforms: line).

  • Pinned every file/directory link to 3d095df; bare "here is the repo" links follow the demo-cloud-native-refcloud-native-ref rename and stay on live main.
  • Fixed a mislabelled caption (pre-existing, unrelated to the move): the SecurityGroupIngressRule / CIDRBlock block is attributed to irsa-composition.yaml, but that file is about IAM roles — the block actually lives in sql-instance-composition.yaml at L85-L105. Retargeted with an anchor.
  • Added one line to the Sources callout explaining the pin and pointing readers to crossplane-configuration for the current compositions.

All 9 Smana/* links in the two files return 200; hugo --minify builds clean.

Smana added 2 commits August 28, 2026 08:39
…/fr)

- cnref.ogenki.io is now the main link when referring to the project;
  GitHub demoted to a secondary source link
- Crossplane composition links moved to the new Smana/crossplane-configuration
  repo (apis/<name>/kcl layout, ghcr.io/smana/crossplane-configuration-* packages)
- Mention AWS EKS + GCP GKE support where the platform is described
- Replace dead links: llm-platform-future-paths.md -> AI platform roadmap,
  postgresql-monitoring-architecture.md -> docs page, docs/decisions -> docs ADRs
The compositions this 2023 post quotes were rewritten in KCL and moved to
Smana/crossplane-configuration, so the file links 404'd (and the two that
still resolved had drifted away from the snippets shown in the post).

- Pin every file/directory link to 3d095df, the commit at publication time,
  so each caption shows the exact code quoted below it
- Follow the demo-cloud-native-ref -> cloud-native-ref rename; the bare
  "here is the repo" links stay on live main
- Fix a mislabelled caption: the SecurityGroupIngressRule / CIDRBlock block
  comes from sql-instance-composition.yaml (L85-L105), not irsa-composition.yaml
- Note in the Sources callout that links are pinned, and point readers to
  crossplane-configuration for the current compositions
@Smana
Smana merged commit 7d876fe into main Aug 28, 2026
1 check passed
@Smana
Smana deleted the docs/cloud-native-ref-refactor-links branch August 28, 2026 06:48
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