Review course pages #63
Merged
Conversation
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
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>
…s-pages Restructure resources pages
Update to main changes
|
Claude encountered an error —— View job I'll analyze this and get back to you. |
Remove automatic PR review trigger - now only runs when someone comments @claude on a PR. This avoids using personal OAuth token for all PRs and makes reviews optional. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Member
Author
|
@claude review this PR |
|
Claude encountered an error —— View job I'll analyze this and get back to you. |
Contributor
There was a problem hiding this comment.
Pull request overview
This pull request restructures the Better Conversations Foundation documentation site to align with a new BCF website structure. The changes primarily involve reorganizing content under a new documentation/ directory, updating internal links, and adding new supporting pages.
Changes:
- Relocated work-with-us, governance, and community content to
documentation/directory - Added new reference pages (stable-links, fullsite-pdf) for easier access
- Updated all internal links and cross-references to reflect new structure
- Added configuration for multi-toc numbering and updated build settings
Reviewed changes
Copilot reviewed 36 out of 129 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| source/work-with-us/index.rst | Deleted - content moved to documentation/work-with-us/index.rst |
| source/work-with-us/governance/index.rst | Deleted - moved to documentation/governance/index.rst |
| source/stable-links.rst | New reference page listing stable URLs for course materials |
| source/index.rst | Major restructure with new grid layout and updated navigation |
| source/glossary.rst | Updated path reference from /work-with-us to /documentation/work-with-us |
| source/fullsite-pdf.rst | New page for PDF download of entire site |
| source/documentation/work-with-us/** | Relocated partnership and certificate content with updated paths |
| source/documentation/using-the-course/** | New section covering versioning, crediting, course definition |
| source/documentation/patterns/index.rst | Enhanced with design philosophy and guidance sections |
| source/documentation/insights/index.rst | Reformatted with consistent structure and related resources |
| source/documentation/guides/** | Reorganized with new checklists section |
| source/documentation/governance/** | Relocated with new governance articles and board structure |
| source/documentation/community/** | Moved with new improvements-and-suggestions page |
| source/documentation/behind-the-scenes/** | Added technical-stack and ai pages |
| source/conf.py | Added sphinx-multitoc-numbering extension and updated paths |
| source/_static/css/custom.css | Added styling for dropdowns and footer sections |
| .github/workflows/claude.yml | Simplified to only trigger on @claude mentions |
| requirements.txt | Added sphinx-multitoc-numbering dependency |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
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.
Significant restructure to align with new BCF site.