Changelog Markdown is lossy: index.md.xml serves HTML, and index.md flattens tabs, captions, and callouts
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 64/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 技術スタック
- markdown, typescript
調査の方向性
Start with getEntryMarkdown and the changelog-related code in src/util/changelog.ts and src/util/rss.ts, then inspect the route that serves index.md.xml. Read renderEntryAsMarkdown on nimbus main at commit 3f1f58d and reproduce the listed feed and post examples. Done means the feed contains Markdown and post output preserves labels, callouts, code samples, package-manager flags, and removes decorative glyphs.
索引モデルが issue の本文から書いたものです。
説明
Example URL(s)
- https://developers.cloudflare.com/changelog/rss/index.md.xml
- https://developers.cloudflare.com/changelog/post/2026-09-28-cloudflare-cli-beta/index.md
- https://developers.cloudflare.com/changelog/post/2026-10-01-workers-oauth-provider-1x/index.md
Actual Behavior
/changelog/rss/index.md.xmlserves HTML.index.md.xml.tscalls the samegetRSSItems()as the HTML feed; the header ofsrc/util/changelog.tsnotes the Markdown variant was not ported to Nimbus.- Post
index.mdoutput (Markdown for Agents conversion of the rendered HTML) loses component meaning: package-manager tabs becomenpmyarnpnpmbunplus four unlabeled code blocks, code captions become*src/index.jsjs*, JS/TS examples appear twice unlabeled, callouts become a bareNoteline, and links keep the↗︎glyph.
Expected Behavior
The Markdown feed contains Markdown, and post Markdown keeps component meaning: one labeled command block, one TypeScript sample, labeled callouts, no decorative glyphs.
Additional information
getEntryMarkdown from @cloudflare/nimbus-docs/runtime produces clean Markdown for these posts and could back index.md.xml (about 40 lines in src/util/changelog.ts, src/util/rss.ts, and the route; I can open a PR). On nimbus main (3f1f58d), renderEntryAsMarkdown has three gaps that affect it:
- top-level MDX
importlines are emitted verbatim :::noteadmonitions stay as raw directive syntax<PackageManagers … global />drops the global flag (npm i cfinstead ofnpm install --global cf)
- 主要言語
- MDX
- スター
- 5.4k
- フォーク
- 17.3k
- 平均マージ
- 1日 20時間
- マージ済み PR（30日）
- 525
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
cloudflare/cloudflare-docs のほかの issue
-
BIMI records for DNS対応中かも @ayushkrsingh946 が 6 日前に担当しました。 オープンcontent:new documentation effort:very-high
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
cloudflare/cloudflare-docs#34744 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
effort:medium engineering
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
cloudflare/cloudflare-docs#34619 ·
メンテナーはふだん 1 日以内に返信
-
Incorrect local link is used in Stream documentation対応中かも @AiAlchemist0 が 13 日前に担当しました。 オープンeffort:medium engineering
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
cloudflare/cloudflare-docs#34497 ·
メンテナーはふだん 1 日以内に返信
-
effort:medium engineering
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
cloudflare/cloudflare-docs#34464 ·
メンテナーはふだん 1 日以内に返信
-
content:edit documentation effort:high
難易度 1/5 1〜3時間 初心者へのやさしさ 67/100
cloudflare/cloudflare-docs#34428 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
cloudflare/cloudflare-docs の issue をすべて見る
似ている issue
-
area/docs framework/hugo help wanted language/markdown
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
メンテナーはふだん 1 日以内に返信
-
documentation good first issue help wanted
難易度 1/5 1〜3時間 初心者へのやさしさ 90/100
メンテナーはふだん 1 日以内に返信
-
Link Checker Reportオープンmaintenance task
難易度 1/5 1〜3時間 初心者へのやさしさ 75/100
メンテナーはふだん 2 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 63/100
openaps/AndroidAPSdocs#2667 ·
メンテナーはふだん 1 日以内に返信
-
clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster no-stale P2
難易度 1/5 1〜3時間 初心者へのやさしさ 75/100
openclaw/crabbox#3055 · コメント 1 件 · リアクション 1 件 ·
メンテナーはふだん 1 日以内に返信