Skip to content

Introduce OpenShell Research and refine the Dev Notes index - #85

Merged
johnnygreco merged 14 commits into
mainfrom
johnny/introducing-openshell-research
Sep 28, 2026
Merged

johnnygreco merged 14 commits into
mainfrom
johnny/introducing-openshell-research

Conversation

@johnnygreco

@johnnygreco johnnygreco commented Sep 28, 2026 •

Copy link
Copy Markdown
Collaborator

Introduces OpenShell Research with an Announcements Dev Note covering the team's mission, immediate research plans, commitment to open research, and invitation to apply. The copy matches the edited Google Doc, with a new subtitle and links to the platform announcement, research repository, and hiring page.

Highlights hiring in a compact “Join us” subsection inviting researchers and engineers who love to build and are passionate about pushing the boundaries of what’s possible through open research. The closing sentence invites readers to reach out and links “applying to join our team” directly to the application page. The Google Doc uses the same copy and a native section heading.

Adds matching light/dark hero images and thumbnails, plus a larger >_ Hello, world! greeting with a green prompt that types in once when the page opens. Reduced-motion and print views show the complete greeting immediately. Regenerates the Dev Notes index, byline, and navigation.

Gives the index's featured note more prominence with a larger headline, summary, and artwork, a green accent beside the featured label, and additional space before recent notes. The layout remains responsive and applies to whichever note is featured by the active filters.

Simplifies tags across all six notes to one metadata list: removes generic openshell and agents tags, consolidates security into agent-security, and preserves runtime-and-harness in the sandbox note's metadata. Removes decorative index tags and the separate card-tag metadata, renderer code, and CSS. Hides non-interactive article tag badges while retaining topic metadata for search. Authoring guidance documents the convention.

Validation:

  • python3 tests/test_render_dev_notes.py — 11 passed.
  • scripts/build-docs.sh — clean build and bundled checks passed.
  • Locked browser layout checks for the announcement, index, and thumbnail placement — 60 passed across Chromium/WebKit, both themes, and desktop/mobile sizes; focused mobile checks after the final wording edit — 4 passed.
  • Index layout, filtering, thumbnail placement, and no-JavaScript checks after the featured-note and tag cleanup — 62 passed.
  • Verified tag badges are hidden on all six articles in Chromium/WebKit and both themes, while normalized tags remain in the generated search index; index cards contain no tag labels. Mobile article layout checks — 24 passed.
  • Verified theme switching, typing behavior, reduced-motion/print fallbacks, and the served documentation preview.
  • After the final hiring subsection update: 20 announcement layout checks passed; application link, keyboard focus, and overflow verified in 8 Chromium/WebKit, light/dark, desktop/mobile combinations. Google Doc heading, application link formatting, and existing links verified by readback. Final compact-heading and copy changes also passed 4 mobile article checks and targeted desktop/mobile checks in both themes.

Hero artwork was generated with imagegen using the official OpenShell brand assets as a reference.

Final editorial review: copy and Google Doc match; announcement date and application destination verified; rendered article reviewed in both themes.

@github-actions

github-actions Bot commented Sep 28, 2026 •

Copy link
Copy Markdown

Documentation preview

The preview has been removed.

@johnnygreco johnnygreco changed the title Introduce OpenShell Research in an announcement Dev Note Introduce OpenShell Research and highlight featured Dev Notes Sep 28, 2026
@johnnygreco johnnygreco changed the title Introduce OpenShell Research and highlight featured Dev Notes Introduce OpenShell Research and refine the Dev Notes index Sep 28, 2026
@johnnygreco
johnnygreco marked this pull request as ready for review September 28, 2026 21:44
@johnnygreco
johnnygreco merged commit 845ce3b into main Sep 28, 2026
16 checks passed
@johnnygreco
johnnygreco deleted the johnny/introducing-openshell-research branch September 29, 2026 02:52
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