ente/README.md

46 lines
1.4 KiB
Markdown
Raw Normal View History

2023-12-16 12:48:47 +00:00
# Docs
Help and documentation for Ente's products
2023-12-16 12:48:47 +00:00
2024-03-01 04:48:44 +00:00
> [!CAUTION]
>
2024-03-01 06:09:07 +00:00
> **Currently not published**. There are bits we need to clean up before
> publishing these docs. They'll likely be available at help.ente.io once we
> wrap those loose ends up.
2024-03-01 04:48:44 +00:00
2023-12-16 12:48:47 +00:00
## Running
Install dependencies
```sh
yarn install
2023-12-16 12:48:47 +00:00
```
Then start a local server
```sh
yarn dev
2023-12-16 12:48:47 +00:00
```
2024-03-01 04:08:18 +00:00
## Workflow
You can edit these files directly on GitHub and open a pull request. That is the
easiest workflow to get started without needing to install anything on your
local machine.
If you plan on contributing frequently, we recommend using an editor. VSCode is
a good choice. Also install the Prettier extension for VSCode, and set VSCode to
2024-03-01 04:48:44 +00:00
format on save. This way the editor will automatically format and wrap the text
using the project's standard, so you can just focus on the content.
2024-03-01 04:08:18 +00:00
2024-03-01 04:48:44 +00:00
Note that we currently don't enforce these formatting standards to make it easy
for people unfamiliar with programming to also be able to make edits from GitHub
directly.
2024-03-01 04:08:18 +00:00
2024-03-01 04:27:28 +00:00
This is a common theme - unlike the rest of the codebase where we expect some
2024-03-01 04:08:18 +00:00
baseline understanding of the tools involved, the docs are meant to be a place
for non-technical people to also provide their input. The reason for this is not
to increase the number of docs, but to bring more diversity to them. Such
diversity of viewpoints is essential for evolving documents that can be of help
to people of varying level of familiarity with tech.