Skip to content

New SEO blogs#2838

Merged
atharvadeosthale merged 13 commits intomainfrom
aishwari/seoblogs1
Apr 17, 2026
Merged

New SEO blogs#2838
atharvadeosthale merged 13 commits intomainfrom
aishwari/seoblogs1

Conversation

@aishwaripahwa12
Copy link
Copy Markdown
Contributor

@aishwaripahwa12 aishwaripahwa12 commented Mar 30, 2026

Added three new blogs

Summary by CodeRabbit

  • New Features
    • Added three new blog posts exploring SDK design practices, evaluating backend platform features, and the impact of quality documentation on developer experience.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 30, 2026

Walkthrough

This pull request adds three new blog post pages to a documentation site and updates the image cache configuration. The changes include three new Markdoc blog post files—covering SDK design, backend platform criteria, and documentation value—each containing frontmatter metadata (title, description, publication date, cover image, author, category, and visibility flags) and article content. Additionally, the cache configuration file is updated with three new entries mapping blog cover image paths to hash values. No existing entries are modified or removed.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'New SEO blogs' accurately reflects the main change—three new blog posts were added to the website.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch aishwari/seoblogs1

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.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In
`@src/routes/blog/post/why-documentation-is-the-most-underrated-developer-feature/`+page.markdoc:
- Line 50: Update the two copy issues in the Markdoc page: change
"StackOverflow" to "Stack Overflow" in the sentence starting with "Poor
documentation search is a silent killer..." (the line referencing Google and
StackOverflow), and adjust the verb for the phrase containing "platforms and
documentation quality" to use plural agreement by replacing the current verb
with "matter" so it reads "...platforms and documentation quality matter."
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e7bc4217-577d-464e-9959-240f46b0440f

📥 Commits

Reviewing files that changed from the base of the PR and between 0d0ed18 and 00e9156.

⛔ Files ignored due to path filters (3)
  • static/images/blog/the-underrated-value-of-great-sdk-design/cover.png is excluded by !**/*.png
  • static/images/blog/what-developers-actually-want-from-a-backend-platform/cover.png is excluded by !**/*.png
  • static/images/blog/why-documentation-is-the-most-underrated-developer-feature/cover.png is excluded by !**/*.png
📒 Files selected for processing (4)
  • .optimize-cache.json
  • src/routes/blog/post/the-underrated-value-of-great-sdk-design/+page.markdoc
  • src/routes/blog/post/what-developers-actually-want-from-a-backend-platform/+page.markdoc
  • src/routes/blog/post/why-documentation-is-the-most-underrated-developer-feature/+page.markdoc


## Search that actually works

Poor documentation search is a silent killer. If a developer cannot find the right page in two or three queries, they will reach for Google instead, and Google may send them to outdated StackOverflow threads rather than your canonical docs.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix two minor copy issues in reader-facing text.

Line 50 should use “Stack Overflow”, and Line 85 should use plural agreement (“matter”) with “platforms and documentation quality.”

✍️ Proposed copy fix
- Poor documentation search is a silent killer. If a developer cannot find the right page in two or three queries, they will reach for Google instead, and Google may send them to outdated StackOverflow threads rather than your canonical docs.
+ Poor documentation search is a silent killer. If a developer cannot find the right page in two or three queries, they will reach for Google instead, and Google may send them to outdated Stack Overflow threads rather than your canonical docs.

- If you are evaluating backend platforms and documentation quality matters to you, the following links are a good starting point.
+ If you are evaluating backend platforms and documentation quality matter to you, the following links are a good starting point.

Also applies to: 85-85

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In
`@src/routes/blog/post/why-documentation-is-the-most-underrated-developer-feature/`+page.markdoc
at line 50, Update the two copy issues in the Markdoc page: change
"StackOverflow" to "Stack Overflow" in the sentence starting with "Poor
documentation search is a silent killer..." (the line referencing Google and
StackOverflow), and adjust the verb for the phrase containing "platforms and
documentation quality" to use plural agreement by replacing the current verb
with "matter" so it reads "...platforms and documentation quality matter."

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aishwaripahwa12 seems legit

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Mar 30, 2026

Greptile Summary

This PR adds three new SEO-focused blog posts covering SDK design, backend platform evaluation, and documentation quality. All three posts remain marked unlisted: true and the broken link at /docs/products/auth/roles in the backend platform post has not been fixed since it was flagged in a prior review cycle.

Confidence Score: 4/5

Safe to merge once the previously-flagged broken internal link is resolved and the unlisted flags are confirmed intentional or removed.

A P1 finding from the previous review (broken /docs/products/auth/roles link in what-developers-actually-want-from-a-backend-platform) remains unresolved; the correct path is /docs/advanced/platform/roles. No new issues were found beyond what was already flagged.

src/routes/blog/post/what-developers-actually-want-from-a-backend-platform/+page.markdoc — broken internal link still present.

Important Files Changed

Filename Overview
src/routes/blog/post/the-underrated-value-of-great-sdk-design/+page.markdoc New blog post on SDK design quality; content and internal links look correct, author slug aishwari is valid.
src/routes/blog/post/what-developers-actually-want-from-a-backend-platform/+page.markdoc New blog post on backend platform evaluation; contains the previously-flagged broken link /docs/products/auth/roles (correct path is /docs/advanced/platform/roles) which still has not been fixed.
src/routes/blog/post/why-documentation-is-the-most-underrated-developer-feature/+page.markdoc New blog post on documentation as a developer feature; content and internal links look correct, author slug atharva is valid.
.optimize-cache.json Auto-generated image optimization cache update; no review concerns.
static/images/blog/the-underrated-value-of-great-sdk-design/cover.png Cover image for the SDK design blog post.
static/images/blog/what-developers-actually-want-from-a-backend-platform/cover.png Cover image for the backend platform blog post.
static/images/blog/why-documentation-is-the-most-underrated-developer-feature/cover.png Cover image for the documentation blog post.

Reviews (6): Last reviewed commit: "Apply suggestion from @atharvadeosthale" | Re-trigger Greptile

Comment thread src/routes/blog/post/the-underrated-value-of-great-sdk-design/+page.markdoc Outdated
Comment thread src/routes/blog/post/the-underrated-value-of-great-sdk-design/+page.markdoc Outdated
The markers of good developer experience:

- **Type-safe SDKs** with proper type inference so errors surface at compile time, not in production
- **Local development tooling** so you're not testing against a shared cloud environment
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Afaik we only let functions to be tested locally, I'd prefer to remove this point

aishwaripahwa12 and others added 5 commits April 17, 2026 14:16
Co-authored-by: Atharva Deosthale <atharva.deosthale17@gmail.com>
Co-authored-by: Atharva Deosthale <atharva.deosthale17@gmail.com>
Co-authored-by: Atharva Deosthale <atharva.deosthale17@gmail.com>
Co-authored-by: Atharva Deosthale <atharva.deosthale17@gmail.com>
Comment thread src/routes/blog/post/the-underrated-value-of-great-sdk-design/+page.markdoc Outdated
@atharvadeosthale atharvadeosthale merged commit 7cf8851 into main Apr 17, 2026
6 checks passed
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.

2 participants