Skip to content

Conversation

Veera-mulge
Copy link
Contributor

@Veera-mulge Veera-mulge commented Oct 7, 2025

What does this PR do?

(Provide a description of what this PR does.)

Test Plan

(Write your test plan here. If you changed any code, please provide us with clear instructions on how you verified your changes work.)

Related PRs and Issues

(If this PR is related to any other PR or resolves any issue or related to any issue link all related PR and issues here.)

Have you read the Contributing Guidelines on issues?

(Write your answer here.)

Summary by CodeRabbit

  • Documentation
    • Added “Updated on October 7, 2025” note across multiple blog posts.
    • Introduced FAQs sections to articles including Flutter Realtime, BaaS guide, Gemini chat app, Personal CRM (SvelteKit), Custom auth flows, WebLLM/WebGPU chatbot, User authentication guide, Sign in with Apple, Portfolio templates, and Serverless functions best practices.
    • Expanded intros/conclusions, improved guidance, and added internal links to relevant docs.
    • Refreshed “More resources”/CTA sections and refined links and formatting.

Copy link
Contributor

coderabbitai bot commented Oct 7, 2025

Walkthrough

This PR updates multiple blog posts under src/routes/blog/post/.markdoc. Changes include adding an “Updated on October 7, 2025.” line, inserting new FAQ sections across posts, and in several files duplicating the FAQ block near the end. Several internal references were converted to internal links (e.g., /docs/products/, related blog posts), with minor content rewrites, re-ordered or adjusted resource lists, and small formatting tweaks. Some posts update provider descriptions and calls to action. No code, APIs, or exported entities are modified; all edits are content-only within Markdoc files.

Possibly related PRs

Suggested reviewers

  • tessamero
  • ebenezerdon
  • LauraDuRy

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Title Check ❓ Inconclusive The title “Update next set of top performing blogs” is related to the changes since the PR updates multiple high-traffic blog posts, but it is overly vague and does not convey the specific nature of the updates such as adding updated timestamps, FAQs, and formatting refinements. Consider revising the title to be more descriptive of the key changes, for example “Add ‘Updated on’ metadata and FAQs to top performing blog posts” to clearly convey the main updates included in the PR.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
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 update-next-set-of-top-performing-blogs

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
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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
src/routes/blog/post/build-personal-crm-sveltekit/+page.markdoc (1)

596-596: Incorrect GitHub repository link.

The link points to appwrite-community/offline-journal, but this article is about building a personal CRM. This appears to be a copy-paste error from another blog post.

Apply this diff to fix the repository link:

-You can find the source code for this application in our [GitHub repo](https://github.com/appwrite-community/offline-journal).
+You can find the source code for this application in our [GitHub repo](https://github.com/appwrite-community/personal-crm).
🧹 Nitpick comments (4)
src/routes/blog/post/build-personal-crm-sveltekit/+page.markdoc (1)

570-591: Inconsistency with AI summary & consider more targeted FAQs.

The AI summary states that this FAQs section was "Repeated...near the end of the post, just before the 'Next steps' section," but only one instance appears in the provided code. This suggests either the duplicate was removed or the summary is outdated.

Additionally, the FAQs are quite generic (e.g., "What's the best tech stack for building a simple CRM?") and don't directly address the specific implementation details covered in this tutorial, such as using the Bulk API, the spreadsheet-style interface, or SvelteKit-specific patterns. Consider tailoring the questions to match the tutorial's unique aspects.

src/routes/blog/post/serverless-functions-best-practices/+page.markdoc (2)

12-14: Consider adding update date to frontmatter.

The update timestamp is helpful for readers, but placing it in the frontmatter as an updated: 2025-10-07 field would provide better metadata structure and consistency with how publication dates are handled.


202-223: FAQ section adds value; consider grammar polish.

The FAQ section effectively reinforces the best practices with accessible Q&A content. The questions align well with the main article sections.

However, note the AI summary claims this FAQ block appears twice in the article, but it only appears once here at line 202.

Optional grammar improvements:

Line 206 has a comma splice that could be refined:

-You only pay for the time your code runs, no idle costs, no manual infrastructure setup.
+You only pay for the time your code runs. No idle costs, no manual infrastructure setup.

Line 214 also has a comma splice:

-Also, clean up unused triggers and logs, they can silently add to costs over time.
+Also, clean up unused triggers and logs; they can silently add to costs over time.
src/routes/blog/post/how-to-set-up-sign-in-with-apple/+page.markdoc (1)

462-466: Good improvement to the resources section.

The "More resources:" heading is clearer than the previous text. The internal blog link on line 466 works well.

For consistency, consider converting the blog link on line 465 to internal format as well (from https://appwrite.io/blog/post/set-up-google-auth-appwrite-react to /blog/post/set-up-google-auth-appwrite-react), matching the style used on line 466.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 185baca and 7d6f64c.

📒 Files selected for processing (10)
  • src/routes/blog/post/appwrite-realtime-for-flutter/+page.markdoc (2 hunks)
  • src/routes/blog/post/backend-as-a-service-baas/+page.markdoc (6 hunks)
  • src/routes/blog/post/build-a-chat-app-with-appwrite-and-gemini/+page.markdoc (2 hunks)
  • src/routes/blog/post/build-personal-crm-sveltekit/+page.markdoc (3 hunks)
  • src/routes/blog/post/building-custom-auth-flows/+page.markdoc (2 hunks)
  • src/routes/blog/post/chatbot-with-webllm-and-webgpu/+page.markdoc (2 hunks)
  • src/routes/blog/post/guide-to-user-authentication/+page.markdoc (3 hunks)
  • src/routes/blog/post/how-to-set-up-sign-in-with-apple/+page.markdoc (3 hunks)
  • src/routes/blog/post/portfolio-template-sites/+page.markdoc (3 hunks)
  • src/routes/blog/post/serverless-functions-best-practices/+page.markdoc (2 hunks)
⏰ 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). (2)
  • GitHub Check: build
  • GitHub Check: tests
🔇 Additional comments (27)
src/routes/blog/post/build-personal-crm-sveltekit/+page.markdoc (2)

12-13: LGTM!

The update timestamp is accurate and matches the PR creation date.


600-601: LGTM!

The documentation links are correctly formatted and point to the appropriate resources.

src/routes/blog/post/portfolio-template-sites/+page.markdoc (3)

14-15: LGTM!

The "Updated on" metadata is appropriate for tracking content revisions and is correctly formatted.


142-142: LGTM!

The Discord server link is a valuable addition to the resources section, helping readers connect with the Appwrite community for support.


111-132: No duplicate FAQ section detected.

src/routes/blog/post/chatbot-with-webllm-and-webgpu/+page.markdoc (4)

497-510: FAQ content looks good.

The FAQ section provides relevant and accurate information that complements the tutorial well. The questions address common concerns about WebLLM's capabilities, hardware requirements, and offline functionality.


515-515: Link position unchanged; only a trailing newline was added. Ignore the reordering request.

Likely an incorrect or invalid review comment.


497-510: Remove incorrect duplication mention from AI summary

The AI summary mentions duplicated FAQ sections, but only one exists at line 497.

Likely an incorrect or invalid review comment.


13-14: Timestamp format and placement are consistent with site standards.

src/routes/blog/post/appwrite-realtime-for-flutter/+page.markdoc (3)

474-495: LGTM! Valuable FAQ additions.

The FAQ section provides clear, practical answers to common questions about Appwrite Realtime. The content is well-structured and addresses key user concerns like security, performance, and cross-framework compatibility.


496-500: Remove duplicate Appwrite Docs link.

Line 500 duplicates the Appwrite Docs link already present at line 498. This redundancy doesn't add value and should be removed.

Apply this diff:

 - [Getting started with Flutter on Appwrite](https://appwrite.io/docs/getting-started-for-flutter)
 - [Flutter playground](https://github.com/appwrite/playground-for-flutter)
 - [Appwrite Docs](https://appwrite.io/docs)
-- [Appwrite Docs](https://appwrite.io/docs)

Likely an incorrect or invalid review comment.


11-13: Fix the update date - it appears to be in the past.

The date "October 7, 2025" is inconsistent with the current timeframe (October 2025). This is likely a typo and should be corrected to reflect the actual update date, possibly "October 7, 2024" or a date in the future if this is scheduled content.

Apply this diff if the intended year was 2024:

-Updated on October 7, 2025.
+Updated on October 7, 2024.

Likely an incorrect or invalid review comment.

src/routes/blog/post/guide-to-user-authentication/+page.markdoc (3)

22-22: Good addition of internal link.

Converting the plain text reference to an internal markdown link improves navigation and SEO. This change aligns with best practices for content interlinking.


125-155: Excellent FAQ and resources sections.

The FAQ section addresses common developer questions with clear, actionable answers, and the "More resources" section consolidates related links effectively. Both additions significantly enhance the post's value.


11-13: Critical: Update date is before the original publication date.

The update date "October 7, 2025" appears before the original publication date "2024-10-25" in the metadata. This is logically impossible and creates confusion. The year should likely be 2024, or if this is a typo in the original date field, both dates need correction.

If the update was in 2024, apply this diff:

-Updated on October 7, 2025.
+Updated on October 7, 2024.

Likely an incorrect or invalid review comment.

src/routes/blog/post/backend-as-a-service-baas/+page.markdoc (5)

75-75: Excellent internal linking improvements.

Converting plain text references to internal markdown links for databases, serverless functions, and notifications enhances navigation and SEO. These changes follow content best practices.

Also applies to: 85-85, 95-95


81-81: Valuable content expansions.

The additions about external database integration, third-party solutions, and user re-engagement provide practical context that enhances the article's usefulness. The flow and relevance are maintained well.

Also applies to: 89-91, 99-101


138-160: Comprehensive and well-structured FAQ section.

The FAQ addresses key developer concerns about BaaS, from conceptual differences to platform selection. The answers are clear, practical, and demonstrate good understanding of developer needs, including important distinctions between open-source and managed solutions.


166-169: Helpful tutorial additions.

The quick-start tutorials and practical examples at the conclusion provide clear next steps for readers. This improves the post's actionability and user experience.


11-13: Critical: Update date precedes the original publication date.

The metadata shows an update date of "October 7, 2025" but the original publication date is "2024-10-09". This temporal inconsistency needs correction. The update year should likely be 2024.

Apply this diff to fix the year:

-Updated on October 7, 2025.
+Updated on October 7, 2024.

Likely an incorrect or invalid review comment.

src/routes/blog/post/build-a-chat-app-with-appwrite-and-gemini/+page.markdoc (5)

13-13: LGTM!

The timestamp addition is consistent with the PR creation date and follows a standard editorial practice for content updates.


549-574: LGTM!

The FAQ section is well-structured and provides valuable, technically accurate information covering common concerns about using Appwrite with AI models, security, storage, scaling, offline development, and authentication.


579-579: Internal blog link is valid /blog/post/function-template-prompt-chatgpt exists at src/routes/blog/post/function-template-prompt-chatgpt/+page.markdoc.


541-541: Documentation link verified
The path /docs/products/functions/develop-locally exists at src/routes/docs/products/functions/develop-locally/.


570-570: Fix the sentence fragment.

The answer contains a sentence fragment: "Yes. When developing locally." This should be restructured for proper grammar.

Apply this diff to fix the grammar:

-Yes. When developing locally. You can run functions offline to test your app logic using mock data or cached responses. Just note that external APIs like Gemini won't respond without an internet connection.
+Yes, when developing locally. You can run functions offline to test your app logic using mock data or cached responses. Just note that external APIs like Gemini won't respond without an internet connection.

Likely an incorrect or invalid review comment.

src/routes/blog/post/how-to-set-up-sign-in-with-apple/+page.markdoc (2)

13-27: LGTM! Good content improvements.

The addition of the update date and internal documentation links enhances the post's value and provides better navigation for readers.


444-460: Excellent addition of the FAQ section.

The FAQ section provides concise, accurate answers to common questions about Sign in with Apple integration. The content aligns well with the article's technical details and adds value for readers seeking quick clarification.

Integrating **Sign in with Apple** using Appwrite allows you to provide a secure and user-friendly authentication experience. With minimal configuration, you can utilize Appwrite's OAuth2 support to integrate third-party login systems across platforms. In this guide, we walked through the full setup process, including configuring Apple Developer credentials, setting up OAuth2 in Appwrite, and testing your integration across different platforms.

For more information on this, check out the [Appwrite OAuth2 documentation](https://appwrite.io/docs/products/auth) and Apple's [Sign in with Apple documentation](https://developer.apple.com/sign-in-with-apple/).
For more information on this, check out the [Appwrite OAuth2 documentation](/docs/products/auth) and Apple's [Sign in with Apple documentation](https://developer.apple.com/sign-in-with-apple/).
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

Verify the OAuth2 documentation link destination.

The link text says "Appwrite OAuth2 documentation" but points to /docs/products/auth, whereas line 23 links to /docs/products/auth/oauth2 for OAuth2-specific content. Consider whether this should point to /docs/products/auth/oauth2 instead for consistency, or if the link text should be adjusted to "Appwrite authentication documentation" to match the destination.

Run the following script to check if both documentation paths exist and their content focus:


🏁 Script executed:

#!/bin/bash
# Description: Verify documentation paths for authentication and OAuth2

# Check if both auth documentation paths exist
echo "Checking for authentication documentation files..."
fd -t f "auth" src/routes/docs/products/ | head -20

# Search for OAuth2-specific content in docs
echo -e "\nSearching for OAuth2 content in docs..."
rg -l "oauth2|OAuth2" src/routes/docs/products/ | head -10

Length of output: 459


Point OAuth2 link to the OAuth2 docs
Change the link target from /docs/products/auth to /docs/products/auth/oauth2 to match the OAuth2-specific documentation.

🤖 Prompt for AI Agents
In src/routes/blog/post/how-to-set-up-sign-in-with-apple/+page.markdoc around
line 442, the link currently points to the generic Auth docs
(/docs/products/auth) but should point to the OAuth2-specific docs; update the
link target to /docs/products/auth/oauth2 so the "Appwrite OAuth2 documentation"
reference goes to the correct OAuth2 page.

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