Skip to content

Databases Documentation#3072

Open
atharvadeosthale wants to merge 2 commits into
stardustfrom
stardust-databases
Open

Databases Documentation#3072
atharvadeosthale wants to merge 2 commits into
stardustfrom
stardust-databases

Conversation

@atharvadeosthale

Copy link
Copy Markdown
Member

Summary

  • Moved TablesDB to live within the databases section and set up redirects from the previous URLs.
  • Added DocumentsDB documentation content, with the other database types in place as placeholders for now.

Split the Databases docs into a menu of database types. The /docs/products/databases
overview becomes a menu (Appwrite databases: TablesDB, DocumentsDB, VectorsDB;
Native databases: PostgreSQL, MySQL). Existing TablesDB content moves under
/tablesdb with its full sidebar; DocumentsDB, VectorsDB, PostgreSQL, and MySQL get
their own sections with placeholder overviews. Adds redirects for all moved pages.
Add DocumentsDB docs (concepts and journeys) under databases/documentsdb, move TablesDB within the databases section with redirects from the previous URLs, and align the backups and bulk operations pages.
@appwrite

appwrite Bot commented Jun 29, 2026

Copy link
Copy Markdown

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)
Site Status Logs Preview QR
 website
69d7f2670014e24571ca
Failed Failed View Logs Preview URL QR Code

Tip

Environment variable changes require redeployment to take effect

@atharvadeosthale atharvadeosthale changed the base branch from main to stardust June 29, 2026 14:43
@greptile-apps

greptile-apps Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

This PR restructures the Databases documentation section by moving TablesDB content into a dedicated tablesdb/ sub-route, adding a new Databases overview page, and adding DocumentsDB documentation with full content. It also introduces a draft flag for blog posts with noindex meta injection and filters drafts from feeds and llms.txt outputs.

  • Route reorganization: all previous /docs/products/databases/* pages are moved under /docs/products/databases/tablesdb/* with 36 redirects added and existing short-URL redirects updated to point directly to the new paths.
  • New docs sections: a Databases overview page lists TablesDB, DocumentsDB, VectorsDB, PostgreSQL, and MySQL; DocumentsDB gets full content; MySQL, PostgreSQL, and VectorsDB get placeholder pages.
  • Blog draft support: publishedPosts is introduced as the canonical public post list, used consistently across listings, RSS/JSON feeds, and llms.txt outputs, with a noindex meta tag on draft post pages.

Confidence Score: 4/5

Safe to merge after fixing the DocumentsDB sidebar parent label; redirect coverage for moved pages is complete and blog draft filtering is correct.

The DocumentsDB sidebar shows 'DOCUMENTSDB' as the parent section label while the back-arrow links to the Databases overview — every other database sub-product layout uses 'Databases' here, and the Sidebar component renders this label as visible text. Fixing it is a one-line change. All other structural changes look correct.

src/routes/docs/products/databases/documentsdb/+layout.svelte needs the parent label corrected from 'DocumentsDB' to 'Databases'.

Important Files Changed

Filename Overview
src/routes/docs/products/databases/documentsdb/+layout.svelte New DocumentsDB sidebar layout; parent nav label is set to 'DocumentsDB' instead of 'Databases', causing a mismatch with all other database sub-product layouts and the breadcrumb text shown to users.
src/redirects.json Added ~36 redirects from the old flat /docs/products/databases/* paths to /docs/products/databases/tablesdb/*; coverage looks complete for all moved pages.
src/routes/docs/products/databases/(overview)/+layout.svelte New overview layout listing TablesDB, DocumentsDB, VectorsDB, PostgreSQL, and MySQL with correct parent href and navigation structure.
src/routes/docs/products/databases/tablesdb/+layout.svelte Old databases layout migrated to tablesdb; all hrefs updated, legacy redirect logic preserved, parent label correctly set to 'Databases'.
src/routes/blog/content.ts Introduces publishedPosts (drafts filtered out) as the canonical public post list; getBlogEntries updated to use it correctly for both category filtering and post listing.
src/markdoc/layouts/Post.svelte Adds draft prop with noindex meta tag injection; draft posts stay accessible at their direct URL but are excluded from search indexing.
src/routes/docs/products/databases/tablesdb/+page.markdoc TablesDB overview page; intro text still reads "Appwrite Databases" generically (copied from the old shared page) and the file lacks a trailing newline.
.optimize-cache.json Cache entries added for all 8 new documentsdb images; extension mismatch (.png entries for .avif files) is intentional per project convention, and every committed image has a corresponding entry.

Comments Outside Diff (1)

  1. src/routes/docs/products/databases/tablesdb/+page.markdoc, line 7-8 (link)

    P2 The intro paragraph still says "Appwrite Databases let you store and query structured data" — generic copy from the old shared databases page. Now that this is the TablesDB product page, the description should name the product directly to avoid confusion with the new Databases overview at /docs/products/databases.

    Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Reviews (1): Last reviewed commit: "Add DocumentsDB documentation section" | Re-trigger Greptile

Comment on lines +7 to +10
const parent: NavParent = {
href: '/docs/products/databases',
label: 'DocumentsDB'
};

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.

P1 The parent.label for DocumentsDB is set to 'DocumentsDB' but the parent.href points to /docs/products/databases (the Databases overview). The Sidebar renders this label as a visible section heading above a back-arrow link. Every other database sub-product layout — tablesdb, mysql, postgresql, vectorsdb — correctly uses label: 'Databases' for this same parent href, so DocumentsDB users would see a confusing "DOCUMENTSDB" label where they'd expect "DATABASES".

Suggested change
const parent: NavParent = {
href: '/docs/products/databases',
label: 'DocumentsDB'
};
const parent: NavParent = {
href: '/docs/products/databases',
label: 'Databases'
};

Comment on lines +17 to 19
{% arrow_link href="/docs/products/databases/tablesdb/quick-start" %}
Quick start
{% /arrow_link %} No newline at end of file

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.

P2 The file is missing a trailing newline. Many editors and linters expect text files to end with a newline character.

Suggested change
{% arrow_link href="/docs/products/databases/tablesdb/quick-start" %}
Quick start
{% /arrow_link %}
{% arrow_link href="/docs/products/databases/tablesdb/quick-start" %}
Quick start
{% /arrow_link %}

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

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.

1 participant