meta: update readme

This commit is contained in:
Henk Verlinde 2022-02-21 16:39:24 +01:00
parent 7c37de9348
commit f9569b7a59
1 changed files with 25 additions and 9 deletions

View File

@ -72,9 +72,15 @@ Nine main reasons why you should use Doks:
## Requirements ## Requirements
Doks uses npm to centralize dependency management, making it [easy to update](https://getdoks.org/docs/help/how-to-update/) resources, build tooling, plugins, and build scripts: - [Git](https://git-scm.com/) — latest source release
- [Node.js](https://nodejs.org/) — latest LTS version or newer
- Download and install [Node.js](https://nodejs.org/) (it includes npm) for your platform. <details>
<summary>Why Node.js?</summary>
Doks uses npm (included with Node.js) to centralize dependency management, making it [easy to update](https://getdoks.org/docs/help/how-to-update/) resources, build tooling, plugins, and build scripts.
</details>
## Get started ## Get started
@ -82,25 +88,35 @@ Start a new Doks project in three steps:
### 1. Create a new site ### 1. Create a new site
Doks is available as a child theme, and a starter theme: Doks is available as a child theme and a starter theme.
- Use the Doks child theme, if you do __not__ plan to customize a lot, and/or need future Doks updates. #### Child theme
- Use the Doks starter theme, if you plan to customize a lot, and/or do __not__ need future Doks updates.
Not quite sure? Use the Doks child theme. - Intended for novice to intermediate users
- Intended for minor customizations
#### Doks child theme - [Easily update npm packages](https://getdoks.org/docs/help/how-to-update/) — __including__ [Doks](https://www.npmjs.com/package/@hyas/doks)
```bash ```bash
git clone https://github.com/h-enk/doks-child-theme.git my-doks-site && cd my-doks-site git clone https://github.com/h-enk/doks-child-theme.git my-doks-site && cd my-doks-site
``` ```
#### Doks starter theme #### Starter theme
- Intended for intermediate to advanced users
- Intended for major customizations
- [Easily update npm packages](https://getdoks.org/docs/help/how-to-update/)
```bash ```bash
git clone https://github.com/h-enk/doks.git my-doks-site && cd my-doks-site git clone https://github.com/h-enk/doks.git my-doks-site && cd my-doks-site
``` ```
<details>
<summary>Help me choose</summary>
Not sure which one is for you? Pick the child theme.
</details>
### 2. Install dependencies ### 2. Install dependencies
```bash ```bash