Skip to content

docs: #202 website refresh#222

Merged
thescientist13 merged 72 commits intomasterfrom
docs/issue-202-website-refresh
Feb 5, 2026
Merged

docs: #202 website refresh#222
thescientist13 merged 72 commits intomasterfrom
docs/issue-202-website-refresh

Conversation

@thescientist13
Copy link
Copy Markdown
Member

@thescientist13 thescientist13 commented Jan 4, 2026

Related Issue

resolves #202 / #60

Summary of Changes

  1. Convert documentation to be based on Greenwood
  2. Refresh website / docs (removed the "experimental" caveat)
  3. Added the beginnings of a REPL #56
  4. Clean up GitHub Actions
  5. Update local node to 22.18.0

TODO

  1. Docs / Examples pages
  2. Home page
  3. ctc-button bundling not working (in layout or frontmatter import)
    Screenshot 2026-01-11 at 2 53 29 PM
  4. rebase and handle docs for feat: #108 fine grained observability #110
  5. final polish + styling
    • syntax highlighting
    • link icons
    • popover menus / links
    • responsive design
    • quote blocks
    • feature box icons / headings
  6. Meta tags / SEO / OG image
  7. footer (w/ socials, etc)?
  8. team review - docs: #202 website refresh #222 (review)
  9. figure out popovertarget / popovertargetaction additions to JSXIntrinsicElements - popover target related attributes are not being recognized by TypeScript #228
  10. Greenwood upstreams - https://github.com/ProjectEvergreen/greenwood/issues?q=label%3Av0.34.0%20label%3Aalpha.3
  11. Lighthouse Checks
  12. docs and examples content review / refresh
  13. README / CONTRIBUTING docs refresh
    • new sandbox location
  14. Cutover
  15. Ecosystem upkeep (11ty, Astro)
  16. issues / discussions cleanup

Nice to have / own issue

  1. copy to clipboard component
  2. test cases (using Vitest) / storybook (nice to have / own issue)
  3. local WCC override? (or own issue) - reference local version of WCC when building the docs website #235
  4. scroll target group for docs / examples sidenav - https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/scroll-target-group
  5. accessible color contrast for syntax highlighting
    Screenshot 2026-01-25 at 7 21 29 PM
  6. attributes are not showing up in the HTML output (Lighthouse compliance) - does this just need - feat(cli): bump to wcc 0.19.0 greenwood#1627
    Screenshot 2026-01-25 at 7 25 46 PM

Upstreams

  1. SVG favicon support - Support SVG favicons copying greenwood#1635
  2. frontmatter tsx import being duplicated as a stylesheet? - dcdbfcc#diff-789ee4d83dd8970d4012ac929895b3ac926993927be9a4f8178b9083d5dfa3aa
    Screenshot 2026-01-04 at 2 53 55 PM
  3. apparently the frontmatter imports fix was incomplete somehow, even on v0.34.0-alpha.2 with the upstream patch 😱 - fix(cli): #1637 filter out frontmatter imports by content type greenwood#1640
    Screenshot 2026-01-31 at 1 32 16 PM
  4. terser plugin had to be disabled for the REPL (and also required patching Rollup bundling for replacing assert -> with) - moved to dedicated playground repo

REPL

  1. editor / UI / syntax highlighting / formatting / responsiveness
  2. document in contributing
  3. add to website nav?
  4. why are we getting sucrase bundling issues / warning on non-REPL pages?

=== STRETCH / OWN ISSUE ===

  • make playground its own website?
  • sanitizer - https://developer.mozilla.org/en-US/docs/Web/API/Sanitizer
  • instrument all methods from wcc
  • typescript / jsx (pull in from wcc)
  • greenwood patch (terser plugin corrupting prod build output; <template> missing from output)
  • error handling
  • support props / data loader
  • support multiple files
  • JS metadata output
  • perma links

@thescientist13 thescientist13 added documentation Improvements or additions to the website and / or documentation REPL labels Jan 4, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented Jan 4, 2026

Deploy Preview for merry-caramel-524e61 failed.

Name Link
🔨 Latest commit 9832297
🔍 Latest deploy log https://app.netlify.com/projects/merry-caramel-524e61/deploys/698412ca7b5eb500089c3a96

@thescientist13 thescientist13 force-pushed the docs/issue-202-website-refresh branch from 6a79130 to 9ce0693 Compare January 4, 2026 22:32
@thescientist13 thescientist13 self-assigned this Jan 4, 2026
@thescientist13 thescientist13 linked an issue Jan 7, 2026 that may be closed by this pull request
@thescientist13 thescientist13 force-pushed the docs/issue-202-website-refresh branch from 9a20fb5 to 2cc80d9 Compare January 11, 2026 20:11
@thescientist13 thescientist13 force-pushed the docs/issue-202-website-refresh branch from 176b979 to f7f9c8e Compare January 21, 2026 01:55
@thescientist13 thescientist13 added this to the 1.0 milestone Jan 25, 2026
@thescientist13 thescientist13 moved this to 👀 In review in [WCC] General Activities Jan 25, 2026
@thescientist13 thescientist13 moved this from 👀 In review to 🏗 In progress in [WCC] General Activities Jan 25, 2026
@thescientist13 thescientist13 marked this pull request as ready for review February 3, 2026 01:32
@thescientist13 thescientist13 moved this from 🏗 In progress to 👀 In review in [WCC] General Activities Feb 3, 2026
Copy link
Copy Markdown
Member Author

@thescientist13 thescientist13 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got some good feedback from the team when reviewing tonight on the home page specifically

  1. Make the copy button inner fill pop (make it white or lighter?)!
  2. Remove redundant copy from banner text / tighten up. Make sure to sell the sizzle 🥩🔥
  3. No underline for home page headings

Also, looks like I lost the "traffic light colors" top borders on the home page "how it works" code blocks. Not sure if intentional with the new syntax highlighting? Should try and get it back caused it did look nice.


We also talked about making the playground its own site, and seemed like a good idea, so will go ahead and bootstrap that repo.

@thescientist13 thescientist13 force-pushed the docs/issue-202-website-refresh branch from 04db49d to 4619f52 Compare February 5, 2026 03:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

0.20.0 documentation Improvements or additions to the website and / or documentation

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

lift component level CSS to <head> for documentation site

1 participant