Merge branch 'main' of https://github.com/Nishantjain10/appwrite-website into docs-sites-integration

Author: Nishantjain10

CONTENT.md

@@ -1,12 +1,10 @@
 # Content Guidelines
 
-## Table of Contents
-
-### Basics
+## Basics
 
 Here are some essential markdoc syntax elements with code examples:
 
-#### Paragraphs and Line Breaks
+### Paragraphs and Line Breaks
 
 To create a new paragraph, simply leave a blank line between lines of text.
 
@@ -16,7 +14,7 @@ This is the first paragraph.
 This is the second paragraph.
 ```
 
-#### Headers
+### Headers
 
 Headers are used to create section titles. Use hashtags (#) for headers, with more hashtags for lower-level headers.
 
@@ -34,7 +32,7 @@ Headers can also be given ID's so they can be linked to and are present in the T
 # Header with ID {% #header-with-id %}
 ```
 
-#### Lists
+### Lists
 
 Create ordered (numbered) and unordered (bulleted) lists using 1., \*, or -.
 
@@ -54,7 +52,7 @@ Create ordered (numbered) and unordered (bulleted) lists using 1., \*, or -.
 - Cherry
 ```
 
-#### Links
+### Links
 
 Create hyperlinks to other web pages or sections within your documentation.
 
@@ -63,7 +61,7 @@ Create hyperlinks to other web pages or sections within your documentation.
 [Link to Section](#section-name)
 ```
 
-#### Images
+### Images
 
 Embed images using the `![alt text](image URL)` syntax.
 
@@ -82,7 +80,7 @@ In most cases, we need images in both light and dark mode such as:
 {% /only_light %}
 ```
 
-#### Code Blocks
+### Code Blocks
 
 Format code blocks using triple backticks (```).
 
@@ -95,15 +93,15 @@ def hello_world():
 
 Remember to use a specific language label if the code is using an Appwrite SDK. Find the [list of available labels here](https://github.com/appwrite/website/blob/41bb6c71a8647016c88393003d3cf6c4edba1f76/src/lib/utils/references.ts#L26).
 
-#### Inline Code
+### Inline Code
 
 Highlight inline code with backticks (`) around the code snippet.
 
 ```md
 Use the `print()` function to display text.
 ```
 
-#### Emphasis and Strong Text
+### Emphasis and Strong Text
 
 Use asterisks (\*) or underscores (\_) for emphasis and double asterisks or underscores for strong text.
 
@@ -114,7 +112,7 @@ _Italic Text_ or _Italic Text_
 **Bold Text** or **Bold Text**
 ```
 
-#### Tables
+### Tables
 
 Tables allow you to display structured data in your documentation. Use pipes (|) to separate columns and hyphens (-) to define the table header.
 
@@ -146,7 +144,7 @@ Alternatively, use markdoc tables.
 {% /table %}
 ```
 
-#### Block Quotes
+### Block Quotes
 
 Block quotes are used to emphasize or highlight text. To create a block quote, use the > symbol at the beginning of the quoted text.
 
@@ -157,9 +155,9 @@ Block quotes are used to emphasize or highlight text. To create a block quote, u
 
 These are the fundamental Markdown syntax elements you'll need to create well-structured and formatted documentation.
 
-### Components
+## Components
 
-#### Tabs
+### Tabs
 
 ```md
 {% tabs %}
@@ -173,7 +171,7 @@ Lorem ipsum dolor sit amet consectetur.
 {% /tabs %}
 ```
 
-#### Multicode Examples
+### Multicode Examples
 
 <pre>
 {% multicode %}
@@ -191,7 +189,9 @@ print('test');
 {% /multicode %}
 </pre>
 
-#### Sections
+Remember to use a specific language label if the code is using an Appwrite SDK. Find the [list of available labels here](https://github.com/appwrite/website/blob/41bb6c71a8647016c88393003d3cf6c4edba1f76/src/lib/utils/references.ts#L26).
+
+### Sections
 
 Use sections when there is a clear step-by-step format to a page. This is used mainly in journey pages and tutorials.
 
@@ -209,15 +209,15 @@ Lorem ipsum dolor sit amet consectetur.
 {% /section %}
 ```
 
-#### Info
+### Info
 
 ```
 {% info title="Public Service Announcement" %}
 Lorem ipsum dolor sit amet consectetur.
 {% /info %}
 ```
 
-#### Icon
+### Icon
 
 Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 
@@ -228,7 +228,7 @@ Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 {% icon icon="github" size="xl" /%}
 ```
 
-#### Icon Image
+### Icon Image
 
 Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 
@@ -239,7 +239,7 @@ Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 {% icon_image src="/icon.png" alt="Icon" size="xl" /%}
 ```
 
-#### Only Light/Dark Theme
+### Only Light/Dark Theme
 
 ```
 {% only_dark %}
@@ -250,7 +250,7 @@ Available sizes are `s`, `m`, `l` and `xl`. Default: `s`.
 {% /only_light %}
 ```
 
-#### Cards
+### Cards
 
 We use cards when we reference a list of links for navigation
 
@@ -276,7 +276,7 @@ Get started with Appwrite and SvelteKit
 {% /cards %}
 ```
 
-#### Cards with icons
+### Cards with icons
 
 We use cards when we reference a list of links for navigation, this variation has icons for extra hints visually.
 
@@ -294,7 +294,7 @@ Configure FCM for push notification to Android and Apple devices.
 {% /cards %}
 ```
 
-#### Accordions
+### Accordions
 
 Use accordions to reduce page size and collapse information that's not important when a reader is scrolling the page.
 

README.md

@@ -41,4 +41,4 @@ Join our growing community around the world! See our official [Blog](https://app
 
 ## License
 
-Appwrite website, docs and blog © 2024 by Appwrite is licensed under [CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/).
+Appwrite website, docs and blog © 2025 by Appwrite is licensed under [CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/).

STYLE.md

@@ -332,6 +332,13 @@ or a page needs to be sufficiently different from existing pages, follow exisitn
 
 If you are proposing a new type of page, discuss an outline in your PR and ask for the Appwrite team's review.
 
+### Placeholders
+
+Whenever there's a need for a placeholder such as for an ID, use angle brackets (<>) over square brackets ([]) because square brackets can be confused for an array.
+
+- ✅ `client.setEndpoint("https://<REGION>.cloud.appwrite.io")`
+- ❌ `client.setEndpoint("https://[REGION].cloud.appwrite.io")`
+
 ## Code snippets
 
 For quick starts and tutorials, a developer must be able to follow code examples from beginning to end

pnpm-lock.yaml

@@ -8,15 +8,15 @@ type SocialStats = {
 
 export const SOCIAL_STATS: SocialStats = {
     GITHUB: {
-        STAT: '48K',
+        STAT: '50K',
         LINK: 'https://github.com/appwrite/appwrite',
         EXTRA: {
-            COMMITS: '24K+',
-            PULL_REQUESTS: '4.5K+',
+            COMMITS: '27K+',
+            PULL_REQUESTS: '4.7K+',
             ISSUES: '3K+',
-            OPEN_ISSUES: '500+',
+            OPEN_ISSUES: '600+',
             CLOSED_ISSUES: '3.3K+',
-            FORKS: '4.3K+',
+            FORKS: '4.4K+',
             CONTRIBUTORS: '800+'
         }
     },
@@ -29,7 +29,7 @@ export const SOCIAL_STATS: SocialStats = {
         LINK: 'https://twitter.com/intent/follow?screen_name=appwrite'
     },
     YOUTUBE: {
-        STAT: '11K+',
+        STAT: '12K+',
         LINK: 'https://www.youtube.com/c/appwrite?sub_confirmation=1'
     }
 };

src/lib/constants.ts

@@ -146,13 +146,13 @@
 </script>
 
 <div class="relative">
-    {#if !page.url.pathname.includes('/init')}
-        <div class="border-smooth relative z-10 border-b bg-[#19191C]">
-            <div class="is-special-padding mx-auto">
-                <AnnouncementBanner />
-            </div>
-        </div>
-    {/if}
+    <!--{#if !page.url.pathname.includes('/init')}-->
+    <!--    <div class="border-smooth relative z-10 border-b bg-[#19191C]">-->
+    <!--        <div class="is-special-padding mx-auto">-->
+    <!--            <AnnouncementBanner />-->
+    <!--        </div>-->
+    <!--    </div>-->
+    <!--{/if}-->
 
     <section
         class="web-mobile-header {resolvedTheme}"