Draft
Conversation
…t instructions - Fetch all 86 Learn Hub articles via Zendesk API into .migration/learn-hub/ (57 in-scope under how-does-icp-work/, 29 out-of-scope; each with learn_hub_* frontmatter and migrated: false) - Add .docs-plan/learn-hub-navigation.md: article-to-target mapping for all 9 content batches with action types (new/expand/reference/skip) and per-batch cross-link replacement tables - Add .docs-plan/learn-hub-migration.md: 9-step agent workflow covering skill loading, staging file reading, per-action templates, sidebar config (no changes needed), verification step for protocol content, intra-batch linking rules, skip article policy, and final cleanup PR checklist with human review gate - Update .docs-plan/decisions.md with migration structural decisions - Update .docs-plan/migration-plan.md with 9 batch entries - Remove Learn Hub from AGENTS.md duplicate-content rule and link rule - Remove Learn Hub LinkCard from docs/index.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Prepares the repo to migrate all developer-relevant content from
learn.internetcomputer.orginto the docs site before Learn Hub is taken down. No new docs pages are created in this PR — it lays the infrastructure for 9 follow-on content PRs.This PR is a draft. All 9 batch content PRs target this branch (
infra/learn-hub-migration-prep) rather thanmain. The full migrated site can be previewed here before anything merges tomain. Once all batches and the final cleanup PR are merged into this branch, a maintainer rebases onmainand marks this PR ready..migration/learn-hub/as Markdown withlearn_hub_*frontmatter (migrated: false). 57 in-scope (underhow-does-icp-work/) and 29 out-of-scope (underout-of-scope/)..docs-plan/learn-hub-navigation.md): every in-scope article mapped to a target file, action type (new/expand/reference/skip), batch number, and per-batch cross-link replacement table. Three articles are explicitly markedskipwith reasons and kept for human review in the final cleanup PR..docs-plan/learn-hub-migration.md): 9-step workflow an agent follows for each batch PR — skill loading (technical-documentation+icp-brand-voiceonly, no icskills needed for concept pages), staging file reading, per-action page templates, sidebar notes (nosidebar.mjschanges needed), technical verification step for protocol-layer content, intra-batch linking rules, skip article policy, and a final cleanup checklist with a human review gate before the staging directory is deleted. Brand voice is called out as critical — Learn Hub articles routinely use banned jargon that must be cleaned up during migration.AGENTS.mdrule updates: removed "Learn Hub" from the "never duplicate external docs" list; updated the "link to old docs" rule to direct agents todocs/concepts/and.docs-plan/learn-hub-migration.mdinstead of Learn Hub.docs/index.mdx: removed the Learn Hub<LinkCard>from the External Resources section..docs-plan/decisions.md(2026-05-06 entry)..docs-plan/migration-plan.md.What comes next (not in this PR)
9 content PRs, one per batch, each targeting
infra/learn-hub-migration-prep. Batches 1–4 have no dependencies and can run in parallel. GitHub Issues for the 9 batches will be created after this PR is reviewed.Sync recommendation
hand-written