Skip to content

RFC: LDK Review Club visual redesign - #61

Open
vincenzopalazzo wants to merge 3 commits into
lightningdevkit:mainfrom
vincenzopalazzo:rfc/site-redesign
Open

RFC: LDK Review Club visual redesign#61
vincenzopalazzo wants to merge 3 commits into
lightningdevkit:mainfrom
vincenzopalazzo:rfc/site-redesign

Conversation

@vincenzopalazzo

Copy link
Copy Markdown
Member

Summary

  • Replaces the minimal Jekyll theme with a dark terminal-style visual identity (Silkscreen + Space Mono, #FFD60A accent, sidebar nav, marquee ticker)
  • Redesigns home, meetings indexes, PR detail pages, and static pages (Code of Conduct, Hosting, Your First Meeting) per the Claude Design handoff
  • Adds RFC 001 (docs/rfc/001-site-redesign.md) and a preview banner (redesign_rfc: true) for community feedback before removing the flag on merge
  • Converts home page to index.html and extracts Liquid/HTML blocks into includes to avoid kramdown escaping meeting cards
  • Groups test-only Gemfile deps (curb, rake, minitest) so bundle install works without native curl extensions for site builds

Review Notes

  • Production-safety review passed (2 rounds)
  • Rebased onto latest upstream/main (includes #3886 host/date fixes)
  • Intentionally removes light/dark toggle and Font Awesome footer — external links moved to sidebar
  • IRC log styling from the old theme is removed; worth confirming no meeting posts still rely on .log-line CSS

Decision Log

Hardest decision: Converting index.md to index.html instead of fighting kramdown's code-block escaping for the upcoming-meeting Liquid loop. The markdown processor was rendering the entire meeting card as escaped plaintext — includes alone weren't enough while the page stayed .md. An HTML front-matter page is the standard Jekyll escape hatch and keeps all other content paths unchanged.

Alternatives rejected:

  • markdown="0" wrapper on a div: inconsistent across Jekyll/kramdown versions and still fragile with nested Liquid
  • Keeping everything in one giant _layouts/home.html: harder to maintain and diverges from how other pages use default layout

Least confident about: Whether dropping the old .log-line / IRC transcript styles breaks readability on any past meeting pages that embed chat logs. I didn't find active log markup in current posts, but if any exist in rendered output we should restore scoped log styles in a follow-up.

Test plan

  • CI passes
  • Home page: hero, upcoming meeting card (not raw HTML), recent meetings list
  • Meetings indexes: by date, PR, component, host, author
  • PR detail page (#3886): tags, metadata grid, questions, Discord CTA
  • Static pages: code-of-conduct, hosting, your-first-meeting
  • Mobile: sidebar collapses, readable on narrow viewports

Recreate the Claude Design handoff (LDK Review Club.dc.html) as a
Jekyll theme with dark terminal styling, sidebar navigation, marquee
ticker, and redesigned home, meetings, and PR detail pages.

Adds RFC 001 documenting the proposal and preview banner flags in
_config.yml for community review before merging to main.
Kramdown was escaping HTML inside index.md as a code block. Convert
the home page to index.html and move the upcoming meeting block into
an include so Liquid output renders as markup.
Several meeting posts use status: done instead of past. Treat both
as completed so the home page recent meetings section stays accurate.
@netlify

netlify Bot commented Jul 11, 2026

Copy link
Copy Markdown

Deploy Preview for ldk-review-club ready!

Name Link
🔨 Latest commit d59bce9
🔍 Latest deploy log https://app.netlify.com/projects/ldk-review-club/deploys/6a52067ae369be0008c63b0e
😎 Deploy Preview https://deploy-preview-61--ldk-review-club.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Jul 11, 2026

Copy link
Copy Markdown

Deploy Preview for courageous-frangipane-fab648 ready!

Name Link
🔨 Latest commit d59bce9
🔍 Latest deploy log https://app.netlify.com/projects/courageous-frangipane-fab648/deploys/6a52067a426941000873c9dd
😎 Deploy Preview https://deploy-preview-61--courageous-frangipane-fab648.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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