Git Product home page Git Product logo

docs's Introduction

The Appwrite Docs ๐Ÿ“

The official https://appwrite.io/docs documentation source code.

๐Ÿš€ Contributing

  1. Clone the repository
  2. Update, add, or fix current docs
  3. Once content is ready, raise a PR

Content Guidelines

  • Use proper title hierarchy (h1-h6) and valid HTML
  • All titles must follow the Chicago style of headline capitalization
  • External links (not https://appwrite.io) should be opened in a new tab (target="_blank")
  • External links should have an HTML attribute of rel="noopener"
  • All filenames should be dash-based and nested in a way that makes sense
  • All images should be in PNG format and 2600x1400px. Do not include any sensitive data in images. All screenshot of the Appwrite dashboard should support light and dark mode.
  • When creating new content or adjusting docs hierarchy, please consult the Appwrite team by opening a Github Issue in this repository

Code Examples

Use the following HTML structure to present code examples:

<div class="ide margin-top-small" data-lang="ruby" data-lang-label="Ruby SDK">
    <pre class="line-numbers"><code class="prism language-ruby" data-prism>#ruby code here...</code></pre>
</div>

As of writing this, these are the supported languages for code examples:

  • Markup
  • CSS
  • CLike
  • JavaScript
  • Bash
  • C#
  • Dart
  • Go
  • GraphQL
  • HTTP
  • Java
  • JSON
  • Kotlin
  • Markup-templating
  • PHP
  • Powershell
  • Python
  • Ruby
  • Swift
  • TypeScript
  • YAML

For showing examples in multiple languages use the list structure:

<ul class="phases clear" data-ui-phases>
    <li>
        <h3>Node.js</h3>
        <div class="ide margin-top-small" data-lang="nodejs" data-lang-label="Node.js SDK">
            <pre class="line-numbers"><code class="prism language-javascript" data-prism>// node code here...</code></pre>
        </div>
    </li>
    <li>
        <h3>PHP</h3>

        <div class="ide margin-top-small" data-lang="php" data-lang-label="PHP SDK">
            <pre class="line-numbers"><code class="prism language-php" data-prism>//php code here..</code></pre>
        </div>
    </li>
</ul>

Don't forget to use proper indenting for all code examples. The indenting of the code examples should be independent from the indentation of the surrounding HTML tags.

Notes

Use the following HTML structure to add important notes inside your docs:

<div class="notice">
  <h2>Important Message</h2>
  <p>Message content here.</p>
</div>

Images

Use the following HTML structure to add images. You can also add support for dark and light mode versions (recommended!). If no dark mode is provided, light mode will be the fallback. Don't forget to provide alternative text for user accessibility and a description for each image.

<?php
$image = new View(__DIR__.'/../general/image.phtml');
    echo $image
        ->setParam('srcLight', '/images-ee/docs/functions-light.png')
        ->setParam('srcDark', '/images-ee/docs/functions-dark.png')
        ->setParam('alt', 'Function settings page.')
        ->setParam('description', 'Function settings page.')
        ->render();
?>

๐Ÿค˜ Support

At any point, if you are stuck, feel free to hop on our Discord server to ask questions or seek mentorship!

Follow Us

Join our growing community around the world! See our official Blog. Follow us on Twitter, Facebook Page, Facebook Group , DEV Community or join our live Discord server for more help, ideas, and discussions.

docs's People

Contributors

2002bishwajeet avatar abnegate avatar adityaoberai avatar brandonroberts avatar callmenoodles avatar christyjacob4 avatar eldadfux avatar elenajp avatar gewenyu99 avatar hyperionstudios avatar kalpesht101 avatar keinisha avatar kodumbeats avatar lohanidamodar avatar meldiron avatar michizhou avatar morthor avatar oscarrg avatar pineappleionic avatar rdmchr avatar ruthlessruler avatar s3ppo avatar sanny-io avatar siyrissoul avatar stnguyen90 avatar torn4dom4n avatar torstendittmann avatar trydalch avatar wess avatar zachos-tech avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.