Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation: Keyboard documentation #1025

Merged
merged 43 commits into from
Jun 19, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
dc25909
doc create and add content to keyboard-documentation, change redirect…
choir241 Jun 10, 2024
116eb16
doc-update alt text for images
choir241 Jun 10, 2024
264e62f
update word flow, change wording for article description, remove tabl…
choir241 Jun 10, 2024
d7c2b18
revert pnpm-lock.yaml changes
choir241 Jun 10, 2024
639c56e
doc - update wording in article description
choir241 Jun 10, 2024
d1eb38a
doc: seperated table into global and project shortcuts, reword articl…
choir241 Jun 10, 2024
e8dce55
add right side navigation for keyboard docs
choir241 Jun 10, 2024
d7dcf6d
docs: add social media links to appwriter section
choir241 Jun 10, 2024
ac8b4f1
doc: update first paragraph/section with better word choice/flow of w…
choir241 Jun 10, 2024
becd24a
doc: reword and change word flows of accessibility, shortcut keys and…
choir241 Jun 11, 2024
72f680b
doc: add mac and windows commands for command center, change any list…
choir241 Jun 11, 2024
53ddd99
doc: split accessibility into 2 paragraphs, add paragraph explaining …
choir241 Jun 11, 2024
286afa4
doc: update wording/setence structure
choir241 Jun 11, 2024
ae261be
docs: change title from Appwriter Specs to Specifications
choir241 Jun 11, 2024
94c85b5
docs: made suggested changes to content, word choices, and sentence s…
choir241 Jun 12, 2024
6343684
docs: make additional content changes to reflect feedback
choir241 Jun 12, 2024
78eee6b
docs: update doc word choice, sentence structure, and flow of sentenc…
choir241 Jun 12, 2024
1ef654a
docs: update description, AI shortcut, and first intro paragraph
choir241 Jun 12, 2024
515b896
docs: move keyboard article under platform overview, move appwriter a…
choir241 Jun 13, 2024
0ba85e7
remove /docs/tooling/keyboard from Sidebar.svelte
choir241 Jun 13, 2024
ebf1a03
docs: update redirect url for assistant, keyboard and appwriter
choir241 Jun 13, 2024
7d1f16b
docs: update Appwriter label for sidebar, move accessibility section …
choir241 Jun 13, 2024
90377da
Update src/routes/docs/tooling/assistant/appwriter/+page.markdoc
choir241 Jun 14, 2024
0cceb36
Update src/routes/docs/advanced/platform/shortcuts/+page.markdoc
choir241 Jun 14, 2024
cf7d199
docs: move the appwrite and keyboard shortcuts pages under command ce…
choir241 Jun 14, 2024
cda46fb
docs: move appwriter to own separate section under tooling, move comm…
choir241 Jun 17, 2024
a94a543
docs: update redirect.json and move command center section under glob…
choir241 Jun 17, 2024
5c6781b
docs: fix broken command-center href link
choir241 Jun 17, 2024
5bf25c1
docs: remove docs/tooling/the-appwriter
choir241 Jun 18, 2024
85e7d3d
docs: update /docs/tooling/command-center and /docs/tooling/assistant…
choir241 Jun 18, 2024
daac6da
Update src/routes/docs/tooling/appwriter/+page.markdoc
choir241 Jun 18, 2024
268c367
Update src/routes/docs/tooling/appwriter/+page.markdoc
choir241 Jun 18, 2024
1a6abae
docs: update macOS content and add transition to accessibilty section
choir241 Jun 18, 2024
46ea0e1
docs: add sidebar navigation to the appwriter article
choir241 Jun 18, 2024
195c74a
docs: change social media links for winning appwriter to list-style
choir241 Jun 18, 2024
83c841a
Update src/routes/docs/advanced/platform/shortcuts/+page.markdoc
choir241 Jun 19, 2024
72d975a
Update src/routes/docs/tooling/appwriter/+page.markdoc
choir241 Jun 19, 2024
595a39d
docs: add primary action keyboard shortcuts, move shortcut to first c…
choir241 Jun 19, 2024
96ee8f2
Merge branch 'docs-keyboard' of https://github.com/appwrite/website i…
choir241 Jun 19, 2024
37f650d
docs: add separate section for items included in the appwriter box
choir241 Jun 19, 2024
b2ba161
docs: change appwriter backlight title and change items in appwriter …
choir241 Jun 19, 2024
d87c90a
docs: change whats in the box list-style to sentence structure
choir241 Jun 19, 2024
8615fea
docs: change last bullet point to full sentence and remove period fro…
choir241 Jun 19, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion src/redirects.json
Original file line number Diff line number Diff line change
Expand Up @@ -659,6 +659,10 @@
"link": "/docs/installation",
"redirect": "/docs/advanced/self-hosting"
},
{
"link": "/keyboard",
"redirect": "/docs/tooling/appwriter"
},
{
"link": "/careers",
"redirect": "https://appwrite.careers"
Expand All @@ -675,4 +679,4 @@
"link": "/cli/install.sh",
"redirect": "https://raw.githubusercontent.com/appwrite/sdk-for-cli/master/install.sh"
}
]
]
5 changes: 5 additions & 0 deletions src/routes/docs/Sidebar.svelte
Original file line number Diff line number Diff line change
Expand Up @@ -111,6 +111,11 @@
label: 'Assistant',
href: '/docs/tooling/assistant',
icon: 'icon-sparkles'
},
{
label: "The Appwriter",
href: '/docs/tooling/appwriter',
icon: 'icon-text'
}
]
},
Expand Down
4 changes: 4 additions & 0 deletions src/routes/docs/advanced/platform/+layout.svelte
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,10 @@
{
label: 'Overview',
href: '/docs/advanced/platform'
},
{
label: 'Shortcuts',
href: '/docs/advanced/platform/shortcuts'
}
]
},
Expand Down
69 changes: 69 additions & 0 deletions src/routes/docs/advanced/platform/shortcuts/+page.markdoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
---
layout: article
title: Keyboard shortcuts
description: Learn to navigate the Appwrite Console efficiently and effectively with your keyboard
---

The Appwrite Console was designed with a keyboard first approach. The Appwrite Console supports keyboard shortcuts that make it easier to navigate and perform actions quicker.

# Shortcuts {% #shortcuts %}

The Appwrite Console supports keyboard shortcuts that make it easier to navigate and perform common actions quicker. The shortcuts use the following pattern: use the first letter from the call to action followed by the resource, product, service, or page you're targeting. For example, the shortcut keys `G` + `S` navigates to the project's Storage screen. Similarly, the shortcut `G` + `F` navigates to the project's Functions screen. However, when there's a conflict with a shortcut key, the following letter is used. For example, since S is already used for Storage, the shortcut for Settings is E. This pattern is used to make usage of shortcuts consistent and predictable.

## Global shortcuts {% #global-shortcuts %}

Developers can also utilize global shortcuts anywhere in the Appwrite Console, allowing instant access to these features from any page on the Console.

|Shortcut|Action|
|----|----|
|`T` then `L`|Set theme to light|
|`T` then `D`|Set theme to dark|
|`T` then `A`|Set theme to dark|
|`A` then `I`|Open Appwrite Assistant|
|`C` then `O`|Create organization|

## Command center

All the Appwrite shortcuts can be found in the [command center](/docs/tooling/command-center).
Use the command center to search for commands or the current page's content.

|PC (Windows / Linux)|macOS|Action|
|----|----|----|
|`Ctrl` + `K`|`⌘` + `K`|Access Command Center|

## Project shortcuts {% #project-shortcuts %}

Within the context of a project, developers can utilize project shortcuts. These shortcuts are automatically enabled once a project is selected on the Console.
These shortcuts allow quick access to the project's pages making it easier and faster to navigate the Console more.

|Shortcut|Action|
|----|----|
|`G` then `P`|Go to projects|
|`G` then `O`|Go to overview|
|`G` then `A`|Go to auth|
|`G` then `D`|Go to databases|
|`G` then `F`|Go to functions|
|`G` then `M`|Go to messaging|
|`G` then `S`|Go to storage|
|`G` then `E`|Go to settings|

stnguyen90 marked this conversation as resolved.
Show resolved Hide resolved
# Primary Actions

Each screen on the console has a concept of a primary action. For example, in the Functions screen, the primary action would be creating a function, in the Databases screen, it would be creating a database and so on. The primary actions are usually triggered using the `C` key as seen in the table below.

|Shortcut|Action|
|----|----|
|`C` then `P`|Create project|
|`C` then `U`|Create user|
|`C` then `A`|Create database|
|`C` then `C`|Create collection|
|`C` then `D`|Create document|
|`C` then `T`|Create attribute|
|`C` then `F`|Create function|
|`C` then `S`|Create storage|

stnguyen90 marked this conversation as resolved.
Show resolved Hide resolved
# Accessibility {% #accessibility %}

Using keyboard shortcuts and other methods, we are committed to making the Appwrite Console accessible to all developers by following the AA-level standards of the [Web Content Accessibility Guidelines (WCAG)](https://www.w3.org/WAI/WCAG22/Understanding/conformance#levels). Following these standards ensures that the Console is usable by people with visual, auditory, physical, speech, cognitive, language, learning, and neurological disabilities.

Good contrast between text and backgrounds, resizable text without loss of content or functionality, and navigable interfaces via keyboard and screen readers guarantee an inclusive environment and allow developers to perform their tasks efficiently. Adhering to these guidelines ensures that the Appwrite Console complies with legal requirements and promotes a positive developer experience for everyone.
9 changes: 9 additions & 0 deletions src/routes/docs/tooling/appwriter/+layout.svelte
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<script lang="ts">
import Docs from '$lib/layouts/Docs.svelte';
import Sidebar from '../../Sidebar.svelte';
</script>

<Docs variant="two-side-navs">
<Sidebar />
<slot />
</Docs>
56 changes: 56 additions & 0 deletions src/routes/docs/tooling/appwriter/+page.markdoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
layout: article
title: The Appwriter
description: Learn about the custom Appwriter mechanical keyboard and its specifications
---

{% only_dark %}
![The Appwriter](/images/docs/keyboard/dark/appwriter.png)
{% /only_dark %}

{% only_light %}
![The Appwriter](/images/docs/keyboard/appwriter.png)
{% /only_light %}

The Appwriter is an exclusive mechanical keyboard custom-designed by the Appwrite team. It is optimized to improve developer productivity and is specially tuned to use with the Appwrite Console.

The Appwriter uses icons from the Appwrite Console and Docs on specific keys, making memorizing keyboard shortcuts easier. For example, `G` then `D` is the shortcut for navigating to your project's databases, and the icon on the `D` key matches the icon for Appwrite Databases.

# What's in the box {% #whats-in-the-box %}

- Appwriter keyboard
- USB-C data/charging cable
- 2-in-1 keycap and switch puller
- Extra PC layout keycaps
- Information card with a QR code

The keyboard comes with Mac layout keys pre-installed for macOS which can also be swapped with the included PC keycaps.

# Specifications {% #specifications %}

|Specification|Details|
|----|----|
|Battery|3000mAh rechargeable battery|
|Design|75% compact design keyboard|
|Keycaps|84 custom dye sublimated PBT keycaps|
|Switches|Gateron G Pro yellow pre-lubed switches|
|Connections|Tri-mode connectivity (2.4Ghz wireless / bluetooth / wired USB-C)|
|Case|Noise dampening case-foam|
|RGB backlight|16 Million colors & multiple lighting effects|
|Switch support|Hot-swappable switches with 3 & 5 pin|
|Rollover|N-key rollover|

# How to change the backlight {% #how-to-change-the-backlight %}

Press `Fn + Home` to change the RGB backlight effect and cycle through all the lights.
stnguyen90 marked this conversation as resolved.
Show resolved Hide resolved

# How to get the Appwriter {% #how-to-get-the-appwriter %}

The Appwriter is currently exclusive to Appwrite events and giveaways.
To get your hands on an Appwriter, look out for events & giveaways on our social media
- [Discord](https://appwrite.io/discord)
- [Github](https://github.com/appwrite/appwrite)
- [X](https://x.com/appwrite)
- [YouTube](https://www.youtube.com/c/appwrite)

Later this year, the Appwriter will be available for purchase in the [Appwrite Store](https://appwrite.store/).
2 changes: 1 addition & 1 deletion src/routes/docs/tooling/assistant/+layout.svelte
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@
<Docs variant="two-side-navs">
<Sidebar />
<slot />
</Docs>
</Docs>
Binary file added static/images/docs/keyboard/appwriter.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/docs/keyboard/dark/appwriter.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading