Rebuild site as MkDocs-Material Intelligence Hub with Python data pipeline#52
Draft
Rebuild site as MkDocs-Material Intelligence Hub with Python data pipeline#52
Conversation
…ne, and documentation - mkdocs.yml: Material theme with Power Green/Copilot Purple palettes, navigation.tabs, search.suggest, content.code.copy features - overrides/main.html: Palette-aware logo switching between green and purple - scripts/sync_repos.py: Python/PyGithub data pipeline (source of truth) with --offline mode for cached data - docs/: Homepage, registry, and guide pages with admonitions - assets/: SVG logos for both visual modes - .github/workflows/deploy-mkdocs.yml: GitHub Pages deployment workflow - requirements.txt: mkdocs-material, PyGithub dependencies - .gitignore: Python/MkDocs/Node artifacts Agent-Logs-Url: https://github.com/rpothin/PowerPlatform-OpenSource-Hub/sessions/1bbd63b3-a630-4afb-a14e-c292dc55b47c Co-authored-by: rpothin <23240245+rpothin@users.noreply.github.com>
…e count Agent-Logs-Url: https://github.com/rpothin/PowerPlatform-OpenSource-Hub/sessions/1bbd63b3-a630-4afb-a14e-c292dc55b47c Co-authored-by: rpothin <23240245+rpothin@users.noreply.github.com>
Copilot created this pull request from a session on behalf of
rpothin
March 29, 2026 13:16
View session
Owner
|
- Replace docs/index.md with minimal frontmatter template selector - Create overrides/home.html with hero, stats, featured repos, focus areas, CTA - Move palette CSS from overrides/main.html into docs/stylesheets/extra.css - Add comprehensive styling: hero gradient+wave, stats grid, featured cards, focus area grid, footer CTA, responsive breakpoints - Update scripts/sync_repos.py: add write_home_data() for homepage partial, update registry index with card-based layout for top 50 repos - Update mkdocs.yml: 3-way palette toggle, navigation.instant, minify plugin, content.tooltips, search separator - Add mkdocs-minify-plugin to requirements.txt Agent-Logs-Url: https://github.com/rpothin/PowerPlatform-OpenSource-Hub/sessions/d7901ae1-46bc-43f9-aa7c-53fed415e519 Co-authored-by: rpothin <23240245+rpothin@users.noreply.github.com>
Owner
|
Remove all elements made redundant by the new MkDocs-Material architecture: - Delete Website/ directory (65 files) — old Docusaurus React/TypeScript app - Delete Scripts/ directory (22 files) — old PowerShell data pipeline and tests - Delete 6 old GitHub workflows (Docusaurus build, npm maintenance, PS validation, popularity snapshots, README auto-update, daily data refresh) - Delete Data/GitHubRepositoriesPopularityScoresSnapshot.json (unused by new arch) - Simplify README.md (2,064 → 69 lines) — remove auto-generated sections, add link to new MkDocs site - Update .gitignore — remove Website/ references - Update .vscode/launch.json — point to MkDocs dev server (port 8000) Kept: Data/GitHubRepositoriesDetails.json (offline cache for sync_repos.py), Configuration/GitHubRepositoriesSearchCriteria.json (search topics), and all new MkDocs architecture files. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Rename Configuration/ → configuration/ and Data/ → data/ for consistent lowercase directory naming across the project. Update all references in scripts/sync_repos.py (path constants and docstrings) and README.md. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Move SVG assets (favicon, logos) to docs/assets/ for correct MkDocs resolution - Fix browser tab title duplication by removing redundant title frontmatter - Remove dark band at top of homepage with transparent header background - Fix logo display using theme-aware partials instead of CSS content swap - Replace theme toggle icons with intuitive sun/moon/auto icons - Remove 'Get Involved' CTA banner from homepage - Add custom 4-column footer with links, resources, and connect section - Enhance registry index and detail page styling with modern card aesthetic - Update sync_repos.py to emit styled wrapper divs and badge elements Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Replace placeholder SVG icons with custom-generated PNG icons featuring interconnected nodes with lightning bolt design. Includes: - Power Platform theme (teal/green gradient) - Copilot Studio theme (purple gradient) - Favicon (32x32), logo (240x240), and apple-touch-icon (180x180) variants - Source 1024x1024 originals preserved for future use Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Remove white background from all icon assets using flood-fill transparency. Regenerate all derived sizes (favicon, logo, apple-touch-icon). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Remove homepage-specific header overrides (transparent background, non-sticky position) that made the header look broken. The header now renders consistently across all pages with the standard MkDocs-Material styling. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add favicon-purple.png for the Copilot Studio theme and a small JS MutationObserver in main.html that watches data-md-color-scheme and switches the favicon between green and purple variants when the user toggles themes. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
MkDocs-Material's .md-logo img selector was overriding the class-only display rules, causing both logos to show simultaneously. theme-matching logo is visible. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Simplify to a 2-way toggle: Power Platform (sunny) ↔ Copilot Studio (night). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Generate 6 category-specific registry pages (power-apps, power-automate, dataverse, copilot-studio, pcf-controls, dynamics-365) from repository topics. Each page includes overview stats, featured repo cards, and a collapsible table for remaining repos. - Add CATEGORIES mapping and generate_category_page() to sync_repos.py - Update homepage focus area links to point to category pages - Add category pages to mkdocs.yml navigation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Power Platform theme: Minor tuning (#0d7d7d teal, #1a9c7d green-teal, #005a5a dark teal) to match the official icon gradient. Copilot Studio theme: Significant realignment from deep purple to magenta-pink (#D946A8) with cyan-blue accent (#38BDF8), matching the icon's actual dominant colors. Improves WCAG contrast from 1.73:1 to 4.71:1 on dark background. - Update CSS variables, hero gradients, and footer gradients - Regenerate favicons and logos from official product icons - Replace sun/moon toggle with custom product icon SVGs - Update mkdocs.yml palette fallbacks (pink/cyan) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…tion and repository tracking
…larity on GitHub topics
… UI/UX - Registry pages: Add gradient hero section with stat pills, language tag pills, and sync info. Reduce featured cards from 50/30 to 12. - Detail pages: Add structured hero with stat tiles (stars, watchers, forks, issues), metadata line, and back navigation. Convert active issue lists to styled HTML cards with proper HTML escaping. - Contribute page: Add gradient hero with stat pills, card-based repo listing with GFI/HW badges, section wrappers for visual separation, and collapsible freshness info. - CSS: Add ~530 lines across 3 new sections (registry hero, detail hero + stat tiles + issue cards, contribute hero + cards) following the mdx- naming convention and card DNA from the home page. - Retarget orphaned .registry-detail CSS selectors to work with new HTML structure. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…s for version constraints
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
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.
scripts/sync_repos.py— addwrite_home_data()to generate homepage stats/featured data as HTML partialscripts/sync_repos.py— updategenerate_registry_index()to produce card-based layout for top 50 reposdocs/index.md— minimal frontmatter withtemplate: home.htmloverrides/home.html— full landing page (hero + stats + featured + focus areas + CTA)overrides/main.html— move CSS to stylesheet, add{% block extrahead %}docs/stylesheets/extra.css— comprehensive styles (palette, hero, grids, cards, responsive)mkdocs.yml— 3-way palette toggle, navigation.instant, minify plugin, search separatorrequirements.txt— add mkdocs-minify-pluginpython scripts/sync_repos.py --offline && mkdocs build— passes clean✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.