Skip to content

Rename field note labels to Dev Note #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
johnnygreco merged 1 commit into from
Jul 20, 2026
Merged

Rename field note labels to Dev Note #13

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/dev-notes/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Dev Notes
description: Research field notes, experiments, milestones, and lessons from building OpenShell research applications.
description: Dev Notes, experiments, milestones, and lessons from building OpenShell research applications.
hide:
- toc
---
Expand Down
2 changes: 1 addition & 1 deletion docs/dev-notes/posts/2026-07-20-policy-controlling-reachy-mini-with-openshell.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ card_tags:
<!-- Generated by scripts/render-dev-notes.py; edit front matter and authors.json. -->
<div class="dev-note-byline">
<p class="dev-note-byline__label">
<span>Field note</span>
<span>Dev Note</span>
<time datetime="2026-07-20">July 20, 2026</time>
<span>Edge AI</span>
</p>
Expand Down
6 changes: 3 additions & 3 deletions scripts/render-dev-notes.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -232,7 +232,7 @@ def render_card_visual(post: dict[str, Any], *, eager: bool = False) -> str:
label = categories[0] if categories else "Research"
date_stamp = post["published"].strftime("%Y.%m.%d")
return f""" <div class="dev-note-card__visual dev-note-card__visual--{variant}" aria-hidden="true">
<span class="dev-note-card__visual-label">Field note / {html.escape(label)}</span>
<span class="dev-note-card__visual-label">Dev Note / {html.escape(label)}</span>
<span class="dev-note-card__visual-index">{date_stamp}</span>
<span class="dev-note-card__visual-mark">&gt;_</span>
</div>"""
Expand Down Expand Up @@ -307,7 +307,7 @@ def render_recent_card(post: dict[str, Any]) -> str:

def render_index_cards(posts: list[dict[str, Any]]) -> str:
if not posts:
body = ' <p class="dev-notes-empty">The first field note is being prepared.</p>'
body = ' <p class="dev-notes-empty">The first Dev Note is being prepared.</p>'
else:
featured = render_featured_card(posts[0])
recent_posts = posts[1:]
Expand Down Expand Up @@ -407,7 +407,7 @@ def render_byline(post: dict[str, Any]) -> str:
<!-- Generated by scripts/render-dev-notes.py; edit front matter and authors.json. -->
<div class="dev-note-byline">
<p class="dev-note-byline__label">
<span>Field note</span>
<span>Dev Note</span>
<time datetime="{published.isoformat()}">{html.escape(format_date(published))}</time>
<span>{html.escape(category)}</span>
</p>
Expand Down
8 changes: 4 additions & 4 deletions tests/test_render_dev_notes.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ def make_post(
filename: str,
*,
date: str = "2026-06-05",
title: str = "A field note",
title: str = "A Dev Note",
description: str = "What the experiment taught us.",
categories: list[str] | None = None,
tags: list[str] | None = None,
Expand Down Expand Up @@ -102,7 +102,7 @@ def test_zero_one_and_many_post_layouts(self) -> None:
second = make_post("2026-06-04-second.md", date="2026-06-04", title="Second")
third = make_post("2026-06-03-third.md", date="2026-06-03", title="Third")

self.assertIn("first field note", renderer.render_index_cards([]))
self.assertIn("first Dev Note", renderer.render_index_cards([]))
one = renderer.render_index_cards([first])
self.assertIn("Featured note", one)
self.assertNotIn("Recent notes", one)
Expand Down Expand Up @@ -192,9 +192,9 @@ def test_existing_byline_replacement_preserves_backslashes(self) -> None:
path = Path(directory) / "post.md"
post = make_post("post.md")
post["path"] = path
post["frontmatter"] = "title: A field note\ndate: 2026-06-05"
post["frontmatter"] = "title: A Dev Note\ndate: 2026-06-05"
post["body"] = (
"# A field note\n\n"
"# A Dev Note\n\n"
f"{renderer.BYLINE_START}\nstale\n{renderer.BYLINE_END}\n\n"
"Body.\n"
)
Expand Down