Skip to content

confluence-mdx: 제목 기반 route와 임시 redirect를 적용합니다 - #1054

Merged
jk-kim0 merged 2 commits into
mainfrom
jk/mdx-confluence-latest-update-20260728
Jul 28, 2026
Merged

confluence-mdx: 제목 기반 route와 임시 redirect를 적용합니다#1054
jk-kim0 merged 2 commits into
mainfrom
jk/mdx-confluence-latest-update-20260728

Conversation

@jk-kim0

@jk-kim0 jk-kim0 commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Summary

Confluence 문서 제목 변경을 canonical public route에 반영하고, 이전 route를 기본 8주 동안 임시 redirect로 제공합니다.

  • 운영 로그 수집 가이드Web Client로 쿠버네티스 클러스터 접속하기의 ko/en/ja 문서 및 이미지 참조를 새 제목 기반 route로 이동합니다.
  • content ID 기반 content-slug-overrides.yaml을 제거하고 현재 영어 제목 번역을 canonical slug로 사용합니다.
  • conversion manifest에서 같은 content ID의 path 이동을 감지해 created_onexpires_on이 있는 redirect registry를 자동 갱신합니다.
  • 만료된 rule은 Next.js runtime에서 제외하고 다음 conversion에서 registry에서도 삭제합니다.
  • 연속 제목 변경 시 기존 redirect를 최신 canonical route로 접어 redirect chain을 방지합니다.
  • 제목 기반 route와 8주 lifecycle을 OpenSpec change로 기록합니다.

Test plan

  • cd confluence-mdx && venv/bin/python -m pytest tests/test_fetch_folders.py tests/test_convert_all_folders.py -q
  • npm test -- --run src/lib/content-route-redirects.test.ts
  • npm run lint
  • npm run build -- --webpack
  • 변경 문서 ko/en/ja Skeleton 비교 및 파일 존재 비교
  • .next/routes-manifest.json에서 locale 유무별 HTTP 307 redirect 확인
  • 생성 sitemap에 새 canonical route만 포함되는지 확인

Additional notes

  • 이번 redirect는 2026-07-28에 생성되며 2026-09-22부터 비활성화됩니다.
  • 최신 Confluence 원문의 app 로그 명령에는 stderr redirection이 다시 빠져 있지만, 알려진 로그 누락 회귀를 재도입하지 않도록 공개 MDX의 2>&1은 유지합니다.
  • 기본 Turbopack local build는 ignored confluence-mdx/venv/bin/python symlink가 repository 밖을 가리킨다는 환경 제한으로 중단되어, 동일 production build를 Webpack으로 검증합니다.

🤖 Generated with Codex

## Summary
문서 제목 변경을 canonical public route에 반영하고 이전 route의 8주 호환 기간을 자동 관리합니다.

- content ID 기반 slug override를 제거하고 현재 영어 제목 번역으로 route를 생성합니다.
- manifest의 content ID별 path 이동을 감지해 생성일과 만료일이 있는 임시 redirect를 기록합니다.
- 만료 rule 제외·정리와 연속 rename의 redirect chain 방지를 구현합니다.
- 운영 로그 수집 가이드와 Web Client 문서를 새 route로 이동하고 영어·일본어 문서를 동기화합니다.

## Test plan
- [x] `venv/bin/python -m pytest tests/test_fetch_folders.py tests/test_convert_all_folders.py -q`
- [x] `npm test -- --run src/lib/content-route-redirects.test.ts`
- [x] `npm run lint`
- [x] `npm run build -- --webpack`
- [x] 변경 문서 ko/en/ja Skeleton 비교

🤖 Generated with Codex
@vercel

vercel Bot commented Jul 28, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Jul 28, 2026 9:02am

Request Review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: caa64df872

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread confluence-mdx/bin/content_redirects.py
## Summary
같은 conversion에서 비워진 route를 다른 content가 재사용할 때 redirect 목적지가 잘못 변경되는 문제를 수정합니다.

- reconciliation 시작 전에 존재한 redirect만 chain collapse 대상으로 제한합니다.
- 같은 pass에서 생성한 redirect가 다른 content의 이동에 따라 변경되지 않도록 합니다.
- content ID 처리 순서가 다른 route 재사용 사례를 회귀 테스트로 추가합니다.
- route 재사용 동작을 OpenSpec Requirement와 Scenario에 반영합니다.

## Test plan
- [x] `venv/bin/python -m pytest tests/test_convert_all_folders.py tests/test_fetch_folders.py -q`
- [x] `git diff --check`

🤖 Generated with Codex
@jk-kim0
jk-kim0 merged commit 8f248b1 into main Jul 28, 2026
7 checks passed
@jk-kim0
jk-kim0 deleted the jk/mdx-confluence-latest-update-20260728 branch July 28, 2026 09:23
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