Skip to content

Redesign the OpenShell research journal - #10

Merged
johnnygreco merged 4 commits into
mainfrom
johnny/ui/research-journal-redesign
Jul 20, 2026
Merged

Redesign the OpenShell research journal#10
johnnygreco merged 4 commits into
mainfrom
johnny/ui/research-journal-redesign

Conversation

@johnnygreco

Copy link
Copy Markdown
Collaborator

Summary

  • redesign the research site with an academic editorial system, responsive light/dark palettes, and restrained OpenShell green accents
  • simplify the information architecture around Dev Notes and Documentation, with clearer navigation and a functional global drawer
  • improve Dev Note cards, author metadata, generated navigation, contribution guidance, and package-documentation routing
  • add renderer validation and unit coverage for dates, authors, markers, card variants, and generated output

Why

The previous site structure and presentation did not clearly communicate the journal's purpose or provide a cohesive path for research notes and their related documentation. This redesign makes the reading experience more distinctive and professional while keeping new posts straightforward to contribute.

Impact

Readers get a clearer, more focused entry point and responsive journal experience. Contributors continue authoring plain Markdown while generated listings, bylines, and navigation remain consistent and validated.

Validation

  • python3 -m unittest discover -s tests — 9 tests passed
  • python3 -m py_compile scripts/render-dev-notes.py
  • python3 scripts/render-dev-notes.py
  • zensical build --clean --strict
  • git diff --check
  • visual inspection at desktop and mobile viewport sizes

@johnnygreco
johnnygreco marked this pull request as ready for review July 20, 2026 15:32
@johnnygreco
johnnygreco merged commit 6a39933 into main Jul 20, 2026
4 checks passed
@johnnygreco
johnnygreco deleted the johnny/ui/research-journal-redesign branch July 20, 2026 22:37
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