Skip to content

Fix blog post ordering and add explicit dates#1689

Merged
aknysh merged 2 commits intomainfrom
osterman/fix-blog-post-order
Oct 21, 2025
Merged

Fix blog post ordering and add explicit dates#1689
aknysh merged 2 commits intomainfrom
osterman/fix-blog-post-order

Conversation

@osterman
Copy link
Member

@osterman osterman commented Oct 21, 2025

what

  • Add explicit date: field to all blog post frontmatter for consistent ordering
  • Fix welcome post date to 2025-10-12 so it appears first in the changelog
  • Fix chdir post filename and date to 2025-10-19 (actual PR merge date)
  • Add <!--truncate--> markers to chdir and pager posts for proper summaries
  • Remove duplicate index.md that was causing routing conflicts

why

  • Blog posts were displaying in incorrect chronological order
  • Some posts were missing truncate markers, causing warnings during build
  • Welcome post should appear first as it introduces the changelog
  • Duplicate index.md was causing Docusaurus routing conflicts

references

  • Fixes blog post ordering issues identified by user

Summary by CodeRabbit

  • Documentation
    • Added new blog posts covering Atmos authentication, provenance tracking, command registry patterns, AWS SSO verification, version list commands, and authentication tutorials.
    • Updated blog post on pager default behavior with migration guidance and configuration instructions.
    • Enhanced blog content metadata and organization.

- Add explicit `date:` field to all blog post frontmatter
- Fix welcome post date to 2025-10-12 so it appears first
- Fix chdir post filename and date to 2025-10-19 (actual merge date)
- Add `<!--truncate-->` markers to chdir and pager posts
- Remove duplicate index.md that was causing routing conflicts
- All posts now in correct chronological order

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@osterman osterman requested a review from a team as a code owner October 21, 2025 14:20
@github-actions github-actions bot added the size/s Small size PR label Oct 21, 2025
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Oct 21, 2025

📝 Walkthrough

Walkthrough

The PR updates blog post metadata by adding publication dates to 8 blog posts, adds truncate markers for excerpt display in 2 posts, removes front matter from the blog index file, and expands content in a pager correction post.

Changes

Cohort / File(s) Summary
Blog posts with date metadata
website/blog/2025-10-13-introducing-atmos-auth.md, website/blog/2025-10-15-provenance-tracking.mdx, website/blog/2025-10-16-command-registry-pattern.md, website/blog/2025-10-17-aws-sso-verification-code-display.md, website/blog/2025-10-17-version-list-command.md, website/blog/2025-10-18-auth-tutorials-geodesic-leapp.md
Added date front-matter field to blog post headers
Blog posts with date and truncate markers
website/blog/2025-10-19-chdir-flag.md, website/blog/welcome.md
Added date front-matter; 2025-10-19-chdir-flag.md also added <!--truncate--> marker for excerpt display
Pager correction post
website/blog/2025-10-15-pager-default-correction.md
Added date field, truncate marker, and expanded Background/Impact sections with migration guidance per PR #1430
Blog index
website/blog/index.md
Removed YAML front-matter block (slug, title, authors, tags)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested reviewers

  • osterman

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The PR title "Fix blog post ordering and add explicit dates" directly addresses the core objectives of the changeset. The raw summary shows that the PR adds explicit date: fields across multiple blog posts (welcome.md, and several 2025-10-XX dated posts), updates existing dates where needed, and adds truncate markers to improve blog rendering. These changes align precisely with the title's claim of fixing blog post ordering through explicit dates. The title is concise, avoids noise, and clearly communicates the primary intent to someone scanning the repository history.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch osterman/fix-blog-post-order

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between d80090d and 7e4fca9.

📒 Files selected for processing (10)
  • website/blog/2025-10-13-introducing-atmos-auth.md (1 hunks)
  • website/blog/2025-10-15-pager-default-correction.md (1 hunks)
  • website/blog/2025-10-15-provenance-tracking.mdx (1 hunks)
  • website/blog/2025-10-16-command-registry-pattern.md (1 hunks)
  • website/blog/2025-10-17-aws-sso-verification-code-display.md (1 hunks)
  • website/blog/2025-10-17-version-list-command.md (1 hunks)
  • website/blog/2025-10-18-auth-tutorials-geodesic-leapp.md (1 hunks)
  • website/blog/2025-10-19-chdir-flag.md (1 hunks)
  • website/blog/index.md (0 hunks)
  • website/blog/welcome.md (1 hunks)
💤 Files with no reviewable changes (1)
  • website/blog/index.md
🧰 Additional context used
📓 Path-based instructions (2)
website/**

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

website/**: Update website documentation in website/ when adding features
Ensure consistency between CLI help text and website documentation
Follow the website's documentation structure and style
Keep website code in website/ and follow its architecture/style; test changes locally
Keep CLI and website documentation in sync; document new features with examples and use cases

Files:

  • website/blog/2025-10-17-version-list-command.md
  • website/blog/2025-10-16-command-registry-pattern.md
  • website/blog/2025-10-15-pager-default-correction.md
  • website/blog/2025-10-15-provenance-tracking.mdx
  • website/blog/welcome.md
  • website/blog/2025-10-17-aws-sso-verification-code-display.md
  • website/blog/2025-10-13-introducing-atmos-auth.md
  • website/blog/2025-10-18-auth-tutorials-geodesic-leapp.md
  • website/blog/2025-10-19-chdir-flag.md
website/blog/*.md

📄 CodeRabbit inference engine (CLAUDE.md)

Add a changelog blog post for PRs labeled minor or major; include truncate marker and required audience tags.

Files:

  • website/blog/2025-10-17-version-list-command.md
  • website/blog/2025-10-16-command-registry-pattern.md
  • website/blog/2025-10-15-pager-default-correction.md
  • website/blog/welcome.md
  • website/blog/2025-10-17-aws-sso-verification-code-display.md
  • website/blog/2025-10-13-introducing-atmos-auth.md
  • website/blog/2025-10-18-auth-tutorials-geodesic-leapp.md
  • website/blog/2025-10-19-chdir-flag.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (7)
  • GitHub Check: Run pre-commit hooks
  • GitHub Check: Build (macos)
  • GitHub Check: Build (windows)
  • GitHub Check: website-deploy-preview
  • GitHub Check: Lint (golangci)
  • GitHub Check: Analyze (go)
  • GitHub Check: Summary
🔇 Additional comments (9)
website/blog/2025-10-13-introducing-atmos-auth.md (1)

6-6: Date field consistently added.

The date metadata aligns with the filename and maintains proper YAML formatting. Truncate marker is correctly positioned for excerpt handling in Docusaurus.

website/blog/welcome.md (1)

6-6: Welcome post correctly ordered first.

Setting the date to 2025-10-12 ensures this introductory post appears at the top of the chronological changelog, matching the PR objective.

website/blog/2025-10-18-auth-tutorials-geodesic-leapp.md (1)

6-6: Metadata consistent with chronological batch.

Date field properly added and matches the filename. Truncate marker placement is correct.

website/blog/2025-10-17-version-list-command.md (1)

6-6: Metadata update consistent with batch.

Date properly formatted and truncate marker appropriately placed for Docusaurus excerpt handling.

website/blog/2025-10-17-aws-sso-verification-code-display.md (1)

6-6: Metadata consistent and properly formatted.

Date field aligns with filename and batch ordering. Truncate marker is correctly positioned.

website/blog/2025-10-15-provenance-tracking.mdx (1)

6-6: Metadata properly added to MDX file.

Date field correctly formatted. Truncate marker positioning accounts for the import statement, which is appropriate for MDX.

website/blog/2025-10-19-chdir-flag.md (1)

6-11: Chdir post correctly updated with date and truncate marker.

Date set to 2025-10-19 as the latest post in the batch (matching PR merge date objective). Truncate marker is properly positioned after the opening paragraph with correct spacing, enabling proper excerpt display in Docusaurus.

website/blog/2025-10-16-command-registry-pattern.md (1)

6-6: Metadata added with proper formatting.

Date field correctly formatted and matches filename. Truncate marker uses valid HTML comment syntax.

website/blog/2025-10-15-pager-default-correction.md (1)

6-6: Metadata updates look good.

The date: field and <!--truncate--> marker are properly added per PR objectives. Truncate placement is correct for excerpt generation, and the date aligns with the blog post's narrative about the pager correction.

Also applies to: 11-12


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@osterman osterman added the no-release Do not create a new release (wait for additional code changes) label Oct 21, 2025
@codecov
Copy link

codecov bot commented Oct 21, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 66.38%. Comparing base (d80090d) to head (7e4fca9).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main    #1689      +/-   ##
==========================================
+ Coverage   66.34%   66.38%   +0.04%     
==========================================
  Files         356      356              
  Lines       41025    41025              
==========================================
+ Hits        27216    27234      +18     
+ Misses      11773    11755      -18     
  Partials     2036     2036              
Flag Coverage Δ
unittests 66.38% <ø> (+0.04%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 4 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@aknysh aknysh merged commit 706a4a3 into main Oct 21, 2025
54 checks passed
@aknysh aknysh deleted the osterman/fix-blog-post-order branch October 21, 2025 15:27
@github-actions
Copy link

These changes were released in v1.196.0-rc.0.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

no-release Do not create a new release (wait for additional code changes) size/s Small size PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants