Skip to content

Conversation

@chandima-d
Copy link
Member

Consolidating changes

chandima-d and others added 11 commits January 25, 2026 16:52
Move pages from documentation/index.rst (Resources) to more logical locations:
- glossary -> root level (site-wide reference)
- fullsite-pdf -> root level (site-wide utility)
- assumptions -> work-with-us (partnership context)
- badges -> work-with-us (partnership/certification)
- stable-links -> work-with-us/behind-the-scenes (technical reference)
- course-improvement -> remains in documentation (pattern philosophy)

This prepares for merging the Resources index page with the landing page.

Related to: BCTT-607

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add "Getting Started" section with guidance for new vs experienced users
- Link to glossary and community forum
- Remove documentation/index.rst (Resources page) as it's now redundant
- Move course-improvement from Resources toctree to main toctree

This completes the Resources page merge into the landing page.

Related to: BCTT-607

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Reorganise toctree into three sections: Delivering the Course,
  Working with Us, and Reference
- Update homepage with two-track Quick Links layout
- Merge course-improvement content into Patterns page intro
- Add cross-links between related sections (course, design, guides,
  patterns, insights, work-with-us)
- Add TODO comments for future educator/researcher/advocate content
- Remove redundant Quick Links heading font-size override in CSS

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Reorder cards to What→Why→How for practitioners (course first, then design rationale)
- Reorder cards to Why→What→How for organisations (partnership benefits first)
- Add Font Awesome icons to cards for visual distinction
- Add Quick start sections with actionable entry points for each track
- Add horizontal rules between intro and tracks for visual separation
- Add comments documenting card order rationale for each audience
- Update card descriptions to be more descriptive and action-oriented

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add centered text alignment to all cards
- Fix typo: "overiew" → "overview"
- Simplify Course Design card description
- Replace email contact with main site contact form link

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Move versioning.rst from course/ to work-with-us/ (policy content)
- Delete 60-Handbook-and-emails.rst (duplicated course-materials content)
- Remove empty Course Resources toctree from course/index.rst

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add icons to Design Constraints section (globe, cubes-stacked, clock, hourglass)
- Change seedling icon for "Separate information from learning" card
- Convert definition lists to line blocks for better spacing
- Add consistent Next Steps/Related Resources sections with navigation pattern
- Document the navigation pattern (one revision path + two forward paths)
- Move stable-links page to Reference section with full link table
- Move checklists from delivery-checklists to guides/checklists

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Move old course module files, handbook drafts, and unused pattern files
to _ignore directory for archival. These files are not part of the
current documentation structure.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Reorganize Work with Us into partnership, certificates subsections
- Create Using the Course section (assumptions, versioning, crediting)
- Create Community section (code of conduct, reporting, suggestions)
- Create Governance section (structure, articles, board, members, IP)
- Add Behind the Scenes section (AI, stable links, technical stack)
- Add Related Resources dropdowns to section index pages
- Update dropdown styling with BCF teal branding
- Simplify QMS header extension to use sphinx-design dropdown structure
- Move unused/archive files to _ignore directory
- Reorganize downloads by version (v1.0, v2.0, v3.0)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Remove left border from dropdown containers and summary elements
- Only insert hr before Document Information on pages without Related Resources
- Simplify detection by checking doctree text content for "Related Resources"

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@chandima-d chandima-d merged commit 3fe78f5 into review-course-pages Jan 26, 2026
1 of 2 checks passed
@claude
Copy link

claude bot commented Jan 26, 2026

Claude encountered an error —— View job


I'll analyze this and get back to you.

@chandima-d chandima-d deleted the restructure-resources-pages branch January 26, 2026 09:44
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