Skip to content

Commit 9a07770

Browse files
committed
docs: spelling corrections
1 parent 7bffe4d commit 9a07770

File tree

4 files changed

+42
-42
lines changed

4 files changed

+42
-42
lines changed

cmd/docs/templates/_schema.tmpl

+11-11
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,10 @@
88
| `apiVersion` | `string` | `v1` | Version of the recipe metadata API schema. Currently should have value "v1". |
99
| `name` | `string` | | Name of the recipe. |
1010
| `version` | `string` | | Version of the recipe. Must be valid [semver](https://semver.org/). |
11-
| `description` | `string` | | Description of what the recipe does |
11+
| `description` | `string` | | Description of what the recipe does. |
1212
| `source` | `string` | | URL to source code for this recipe. |
1313
| `templateExtension` | `string` | | File extension of files in "templates" directory which should be templated. Files not matched by this extension will be copied as-is. If left empty (the default), all files will be templated. |
14-
| `initHelp` | `string` | | A message which will be showed to an user after a succesful recipe execution. Can be used to guide the user what should be done next in the project directory. Supports templating |
14+
| `initHelp` | `string` | | A message which will be shown to an user after a successful recipe execution. Can be used to guide the user on what should be done next in the project directory. Supports templating. |
1515
| `ignorePatterns` | `[]string` | | Glob patterns for ignoring generated files from future recipe upgrades. Ignored files will not be regenerated even if their templates change in future versions of the recipe. |
1616
| `vars` | [`[]Variable`](#variable) | | An array of variables which can be used in templates. The user will be prompted to provide the value for the variable if not set with `--set` flag. |
1717

@@ -21,16 +21,16 @@
2121

2222
| Attribute | Type | Default | Description |
2323
| --- | --- | --- | --- |
24-
| `name` | `string` | | The name of the variable. It is also used as unique identifier, so two variables can not have the same name. |
24+
| `name` | `string` | | The name of the variable. It is also used as an unique identifier, so two variables cannot have the same name. |
2525
| `description` | `string` | | Description of the variable. Will be shown to the user when "show help" is activated. |
2626
| `default` | `string` | | Default value of the variable. |
27-
| `confirm` | `bool` | `false` | If set to true, the prompt will be yes/no question, and the value type will be boolean. |
27+
| `confirm` | `bool` | `false` | If set to true, the prompt will be a yes/no question, and the value type will be boolean. |
2828
| `optional` | `bool` | `false` | If set to true, the variable can be left empty. |
2929
| `options` | `[]string` | | The user selects the value from a list of options. |
3030
| `multi` | `bool` | `false` | If set to true, the user can select multiple options defined by the `options` property. |
3131
| `validators` | [`[]Validator`](#validator) | | Validators for the variable. |
3232
| `if` | `string` | | Makes the variable conditional based on the result of the expression. The result of the evaluation needs to be a boolean value. Uses https://github.com/expr-lang/expr. |
33-
| `columns` | `[]string` | | Set the variable as a table type with columns defined by this property. |
33+
| `columns` | `[]string` | | Set the variable as a table type with columns defined by this property. |
3434

3535
### Validator
3636

@@ -50,8 +50,8 @@
5050
| Attribute | Type | Default | Description |
5151
| --- | --- | --- | --- |
5252
| `values` | `map[string]any` | | Values to use to render the recipe templates. Map key is the name of the variable and value is the variable value. |
53-
| `expectedInitHelp` | `string` | | Expected initHelp of the recipe when rendered with the values specified in the test |
54-
| `ignoreExtraFiles` | `bool` | | If true, test will pass even though templates generated more files than the test specifies. This is useful when creating specific test cases for large recipes. |
53+
| `expectedInitHelp` | `string` | | Expected initHelp of the recipe when rendered with the values specified in the test. |
54+
| `ignoreExtraFiles` | `bool` | | If true, the test will pass even though templates generated more files than the test specifies. This is useful when creating specific test cases for large recipes. |
5555

5656
## Sauce schema (`sauces.yml`)
5757

@@ -61,9 +61,9 @@
6161
| --- | --- | --- | --- |
6262
| `apiVersion` | `string` | `v1` | Version of the sauce API schema. Currently should have value "v1". |
6363
| `recipe` | [`Recipe`](#recipe-schema-recipeyml) | | The recipe which was used to render the sauce. |
64-
| `values` | `map[string]any` | | Values which was used to execute the recipe. |
65-
| `files` | `map[string]File` | | Files genereated from the recipe |
66-
| `id` | `string` | | Random unique ID whose value is determined on first render and stays the same on subsequent re-renders (upgrades) of the sauce. Can be used for example as a seed for template random functions to provide same result on each template. |
64+
| `values` | `map[string]any` | | Values which were used to execute the recipe. |
65+
| `files` | `map[string]File` | | Files generated by the recipe. |
66+
| `id` | `string` | | Random unique ID whose value is determined on first render and stays the same on subsequent re-renders (upgrades) of the sauce. Can be used for example as a seed for template random functions to provide the same result on each template. |
6767
| `from` | `string` | | Defines the repository where updates should be checked for the recipe. |
6868
| `subpath` | `string` | | Subpath which is used as a path prefix when saving and loading the sauce files. This is commonly used in monorepos. |
6969

@@ -85,6 +85,6 @@
8585
| `name` | `string` | | The name of the recipe. |
8686
| `version` | `string` | | The version of the recipe. |
8787
| `repository` | `string` | | The repository where the recipe is located. Can be a local path or remote URL. |
88-
| `values` | `map[string]any` | | Values which was used to execute the recipe. |
88+
| `values` | `map[string]any` | | Values which were used to execute the recipe. |
8989

9090
{{- end }}

docs/site/docs/installation.mdx

+7-7
Original file line numberDiff line numberDiff line change
@@ -33,15 +33,15 @@ winget upgrade jalapeno
3333
Cross-platform binaries are provided with each release of Jalapeno. These can manually be
3434
downloaded and installed from [GitHub releases](https://github.com/futurice/jalapeno/releases/).
3535

36-
In short the process is:
36+
In short, the process is:
3737

3838
1. Download [the latest version of Jalapeno](https://github.com/futurice/jalapeno/releases/latest)
3939
for your platform
4040
2. Extract the archive
4141
3. Make the binary executable
42-
4. Rename and move the binary to proper location
42+
4. Rename and move the binary to the proper location
4343

44-
For example on MacOS (running on Apple Silicon) this can be done with:
44+
For example, on macOS (running on Apple Silicon) this can be done with:
4545

4646
```bash
4747
curl -L https://github.com/futurice/jalapeno/releases/latest/download/jalapeno-darwin-arm64.tar.gz -o jalapeno.tar.gz
@@ -52,11 +52,11 @@ mv jalapeno /usr/local/bin/jalapeno
5252

5353
## Use via Docker
5454

55-
It is possible to use Jalapeno via Docker without installing it locally. Jalapeno image is available
55+
It is possible to use Jalapeno via Docker without installing it locally. The Jalapeno image is available
5656
from the GitHub Container Registry, and thus the following command on a \*nix system is equivalent
5757
to running `jalapeno` locally:
5858

59-
```bash tab={"label":"MacOS and Linux"}
59+
```bash tab={"label":"macOS and Linux"}
6060
docker run -it --rm -v $(pwd):/workdir ghcr.io/futurice/jalapeno:latest
6161
```
6262

@@ -73,12 +73,12 @@ docker run -it --rm -v ${PWD}:/workdir ghcr.io/futurice/jalapeno:latest
7373
First, make sure you have [Go](https://go.dev/doc/install) and
7474
[Task](https://taskfile.dev/installation) installed.
7575

76-
Then you can compile the binary with following commands:
76+
Then you can compile the binary with the following commands:
7777

7878
```bash
7979
git clone https://github.com/futurice/jalapeno.git
8080
cd jalapeno
8181
task build
8282
```
8383

84-
After this the binary is available on path `./bin/jalapeno`.
84+
After this, the binary is available on the path `./bin/jalapeno`.

docs/site/docs/intro.mdx

+5-5
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,14 @@ hide_title: true
99
<img src="img/logo.png" width="70%" />
1010
</div>
1111

12-
Jalapeno is **a templating system** which support complex templating while staying user friendly. Templates used by Jalapeno are called _recipes_.
12+
Jalapeno is **a templating system** which supports complex templating while staying user-friendly. Templates used by Jalapeno are called _recipes_.
1313

1414
To get started, [install](/installation) the tool and follow the [getting started](/usage#getting-started) guide.
1515

1616
## Features
1717

18-
- **Easy to use templates**: The CLI guides the user as much as possible when using recipes. This is done by prompting the user interactively for required template values, providing validation for the values, giving hints about what to do after executing the recipe etc.
18+
- **Easy to use templates**: The CLI guides the user as much as possible when using recipes. This is done by prompting the user interactively for required template values, providing validation for the values, giving hints about what to do after executing the recipe, etc.
1919
- **Modular**: A project can use multiple recipes at the same time, so you can compose your projects from multiple smaller template modules. This helps to keep the recipes simple and focused.
20-
- **Continous integration**: Recipes are versioned, and new versions of the recipe can be merged to existing projects. Recipes can be shared via OCI compatible registries (aka container registries) so project CI/CD pipelines which already utilize the registry can easily check and notify the developers if there are new versions available for the recipes.
21-
- **Tweakable templates**: Since every project is a little bit different, manual tweaks are often needed after a recipe has been executed. Jalapeno can still update the recipes used in a project by detecting which files has been manually edited and solve the merge conflicts. This way the project can stay up to date with the recipe, while still keeping the manual tweaks.
22-
- **Snapshots tests**: Recipes can be tested with snapshot tests, which reduces regression when developing the templates by ensuring that the templates produces expected outputs.
20+
- **Continuous integration**: Recipes are versioned, and new versions of the recipe can be merged into existing projects. Recipes can be shared via OCI compatible registries (aka container registries) so project CI/CD pipelines which already utilize the registry can easily check and notify the developers if there are new versions available for the recipes.
21+
- **Tweakable templates**: Since every project is a little bit different, manual tweaks are often needed after a recipe has been executed. Jalapeno can still update the recipes used in a project by detecting which files have been manually edited and solving the merge conflicts. This way the project can stay up to date with the recipe, while still keeping the manual tweaks.
22+
- **Snapshot tests**: Recipes can be tested with snapshot tests, which reduces regression when developing the templates by ensuring that the templates produce expected outputs.

0 commit comments

Comments
 (0)