docs: blog layout update by acekyd · Pull Request #8472 · aaif-goose/goose

acekyd · 2026-04-10T17:45:12Z

Summary

Updated the blog layout to better highlight the content we are putting out.
Edited existing blogposts with the featured images, hence multiple files touched.
Enabled featured posts.

Testing

Visual change, manually tested.

Screenshots/Demos (for UX changes)

Before:

After:

github-actions · 2026-04-10T17:48:42Z

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-04-10 23:39 UTC

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f6e8de8b6e

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

documentation/src/theme/BlogPostItem/Header/Info/index.tsx

documentation/src/theme/BlogListPage/index.tsx

- Remove hardcoded author map from Info/index.tsx; the wrapped Info component already renders resolved author data from Docusaurus - Replace client-side new Date().toLocaleDateString() with metadata.formattedDate in BlogListPage to avoid timezone-based off-by-one day shifts for viewers west of UTC Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Angie Jones <jones.angie@gmail.com>

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 230b332a69

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

documentation/src/theme/BlogListPage/index.tsx

- Use imageURL (Docusaurus camelCase) alongside image_url when detecting and rendering author avatars so resolved authors show their photos - Exclude only the single promoted featured post from the grid, so additional featured posts remain visible - Bump postsPerPage from 20 to 22 to fill 3-column grid rows evenly with 1 featured post + 21 grid posts Signed-off-by: Angie Jones <jones.angie@gmail.com> Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Angie Jones <jones.angie@gmail.com>

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4bd894dc93

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-04-10T19:08:24Z

documentation/src/theme/BlogListPage/index.tsx

+      {posts.map((post, index) => {
+        const url = useBaseUrl(post.content.metadata.permalink);
+        const imageUrl = post.content.frontMatter.image ? useBaseUrl(post.content.frontMatter.image) : null;


Move useBaseUrl calls out of the posts map

useBaseUrl is a React hook (it calls other hooks internally), but it is invoked inside posts.map(...) here, so the number/order of hook calls depends on how many posts are rendered. If this component re-renders with a different page payload (for example, navigating across paginated blog pages where item counts differ), React can throw a hooks-order error (Rendered more/fewer hooks than expected) and break the blog list view. Resolve URLs with useBaseUrlUtils().withBaseUrl(...) or by moving each card into a child component that calls hooks at the top level.

Useful? React with 👍 / 👎.

Copy automate-taste.png and goose-maintains-goose.png to /static/img/blog/ and add image: frontmatter so they render as thumbnails in the blog list grid. Signed-off-by: Angie Jones <jones.angie@gmail.com> Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Angie Jones <jones.angie@gmail.com>

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 35767d64c9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-04-10T19:46:50Z

documentation/src/theme/BlogListPage/index.tsx

+        const url = useBaseUrl(post.content.metadata.permalink);
+        const imageUrl = post.content.frontMatter.image ? useBaseUrl(post.content.frontMatter.image) : null;
+        const title = post.content.metadata.title;
+        const formattedDate = post.content.metadata.formattedDate;


Render post dates from an existing metadata field

The new list renderer reads post.content.metadata.formattedDate, but blog list item metadata does not provide formattedDate (it provides date), so the date text is empty in the rendered cards. In the generated output this leaves <div class="postDate"> blank for every post, which removes publication dates from the blog index and featured section.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-04-10T19:46:50Z

documentation/blog/2026-01-15-why-tool-descriptions-arent-enough/index.md

 ---
 title: "Why Tool Descriptions Aren’t Enough"
 description: "I thought better tool descriptions would solve everything. They didn’t. Here’s what finally made MCP sampling click for me."
+image: /img/blog/tool-descriptions-banner.png


Refresh hardcoded social image URLs after banner renames

This post switched to the new /img/blog/tool-descriptions-banner.png asset, but the hardcoded <head> tags later in the same file still point to .../assets/images/blogbanner-...png. After the rename, that old asset path no longer exists in the build output, so og:image/twitter:image resolve to 404 and social previews break for this post (and similarly renamed posts in this commit).

Useful? React with 👍 / 👎.

useBaseUrl was being called inside posts.map() in BlogPostGrid, violating React's Rules of Hooks. Extracted each card into a BlogPostCard component so hooks are called at the top level. Signed-off-by: Angie Jones <jones.angie@gmail.com> Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Angie Jones <jones.angie@gmail.com>

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 37da898e90

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

documentation/blog/2026-02-25-order-lunch-with-goose/index.md

Fixes og:image/twitter:image resolution for social previews. Signed-off-by: Angie Jones <jones.angie@gmail.com> Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Angie Jones <jones.angie@gmail.com>

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9bf6bbb137

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-04-10T21:27:39Z

documentation/blog/2026-02-23-goose-v1-25-0/index.md

 description: "goose v1.25.0 brings macOS sandboxing, a unified summon extension, rich MCP app UIs, agentic CLI upgrades, and SLSA build provenance."
 authors:
  - debbie
+image: /img/blog/goose-v1-25-0.png


Update social meta image URL to moved banner path

This post now declares /img/blog/goose-v1-25-0.png as its banner, but the hardcoded <head> metadata later in the file still references the old hashed assets/images/banner-...png URL for og:image/twitter:image. Because banner.png was moved out of the post directory in this commit, that legacy hashed asset is no longer produced, so social shares for this article will point to a missing image unless the manual meta tags are updated (or removed in favor of front matter).

Useful? React with 👍 / 👎.

acekyd added 3 commits April 10, 2026 18:47

Blog layout -still broken

02774a1

Updated blog layout

f80adf6

Update existing posts

f6e8de8

acekyd requested a review from michaelneale April 10, 2026 17:45

acekyd requested review from DOsinga, angiejones and blackgirlbytes as code owners April 10, 2026 17:45

chatgpt-codex-connector bot reviewed Apr 10, 2026

View reviewed changes

documentation/src/theme/BlogPostItem/Header/Info/index.tsx Outdated Show resolved Hide resolved

documentation/src/theme/BlogListPage/index.tsx Outdated Show resolved Hide resolved

chatgpt-codex-connector bot reviewed Apr 10, 2026

View reviewed changes

documentation/src/theme/BlogListPage/index.tsx Outdated Show resolved Hide resolved

documentation/src/theme/BlogListPage/index.tsx Outdated Show resolved Hide resolved

angiejones force-pushed the ace/blog-update branch from 230b332 to 4bd894d Compare April 10, 2026 19:01

chatgpt-codex-connector bot reviewed Apr 10, 2026

View reviewed changes

documentation/blog/2026-02-25-order-lunch-with-goose/index.md Outdated Show resolved Hide resolved

angiejones approved these changes Apr 10, 2026

View reviewed changes

fix(docs): add leading slash to lunch-with-goose image path

9bf6bbb

Fixes og:image/twitter:image resolution for social previews. Signed-off-by: Angie Jones <jones.angie@gmail.com> Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Angie Jones <jones.angie@gmail.com>

chatgpt-codex-connector bot reviewed Apr 10, 2026

View reviewed changes

angiejones added this pull request to the merge queue Apr 10, 2026

Merged via the queue into main with commit 3f52775 Apr 10, 2026
21 checks passed

angiejones deleted the ace/blog-update branch April 10, 2026 23:33

Conversation

acekyd commented Apr 10, 2026

Summary

Testing

Screenshots/Demos (for UX changes)

Uh oh!

github-actions bot commented Apr 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector bot Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector bot Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector bot Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions bot commented Apr 10, 2026 •

edited

Loading