mirror of
https://github.com/VictoriaMetrics/VictoriaMetrics.git
synced 2024-11-23 12:31:07 +01:00
docs/Single-server-VictoriaMetrics.md: recommend periodic running of make spellcheck
command
This is a follow-up for fabf0b928e
Updates https://github.com/VictoriaMetrics/VictoriaMetrics/pull/6562
This commit is contained in:
parent
c6e7fb688b
commit
cda6a31ae8
22
README.md
22
README.md
@ -2643,24 +2643,30 @@ It is built from `*.md` files located in [docs](https://github.com/VictoriaMetri
|
|||||||
and gets automatically updated once changes are merged to [master](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master) branch.
|
and gets automatically updated once changes are merged to [master](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master) branch.
|
||||||
To update the documentation follow the steps below:
|
To update the documentation follow the steps below:
|
||||||
- [Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)
|
- [Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)
|
||||||
VictoriaMetrics repo and apply changes to the docs:
|
VictoriaMetrics repo and apply changes to the docs:
|
||||||
- To update [the main page](https://docs.victoriametrics.com/) modify [this file](https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/README.md).
|
- To update [the main page](https://docs.victoriametrics.com/) modify [this file](https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/README.md).
|
||||||
- To update other pages, apply changes to the corresponding file in [docs folder](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/docs).
|
- To update other pages, apply changes to the corresponding file in [docs folder](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/docs).
|
||||||
- If your changes contain an image then see [images in documentation](https://docs.victoriametrics.com/#images-in-documentation).
|
- If your changes contain an image then see [images in documentation](https://docs.victoriametrics.com/#images-in-documentation).
|
||||||
- Once changes are made, execute the command below to finalize and sync the changes:
|
- Once changes are made, execute the command below to finalize and sync the changes:
|
||||||
```sh
|
|
||||||
make docs-sync
|
```sh
|
||||||
```
|
make docs-sync
|
||||||
|
```
|
||||||
|
|
||||||
- Create [a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
|
- Create [a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
|
||||||
with proposed changes and wait for it to be merged.
|
with proposed changes and wait for it to be merged.
|
||||||
|
|
||||||
Requirements for changes to docs:
|
Requirements for changes to docs:
|
||||||
|
|
||||||
- Keep backward compatibility of existing links. Avoid changing anchors or deleting pages as they could have been
|
- Keep backward compatibility of existing links. Avoid changing anchors or deleting pages as they could have been
|
||||||
used or posted in other docs, GitHub issues, stackoverlow answers, etc.
|
used or posted in other docs, GitHub issues, stackoverlow answers, etc.
|
||||||
- Keep docs simple. Try using as simple wording as possible.
|
- Keep docs clear, concise and simple. Try using as simple wording as possible, without loosing the clarity.
|
||||||
- Keep docs consistent. When modifying existing docs, verify that other places referencing to this doc are still relevant.
|
- Keep docs consistent. When modifying existing docs, verify that other places referencing to this doc are still relevant.
|
||||||
- Prefer improving the existing docs instead of adding new ones.
|
- Prefer improving the existing docs instead of adding new ones.
|
||||||
- Use absolute links.
|
- Use absolute links. This simplifies moving docs between different files.
|
||||||
|
|
||||||
|
Priodically run `make spellcheck` - this command detects spelling errors at `docs/` folder. Please fix the found spelling errors
|
||||||
|
and commit the fixes in a separate commit.
|
||||||
|
|
||||||
### Images in documentation
|
### Images in documentation
|
||||||
|
|
||||||
|
@ -2646,24 +2646,30 @@ It is built from `*.md` files located in [docs](https://github.com/VictoriaMetri
|
|||||||
and gets automatically updated once changes are merged to [master](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master) branch.
|
and gets automatically updated once changes are merged to [master](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master) branch.
|
||||||
To update the documentation follow the steps below:
|
To update the documentation follow the steps below:
|
||||||
- [Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)
|
- [Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)
|
||||||
VictoriaMetrics repo and apply changes to the docs:
|
VictoriaMetrics repo and apply changes to the docs:
|
||||||
- To update [the main page](https://docs.victoriametrics.com/) modify [this file](https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/README.md).
|
- To update [the main page](https://docs.victoriametrics.com/) modify [this file](https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/README.md).
|
||||||
- To update other pages, apply changes to the corresponding file in [docs folder](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/docs).
|
- To update other pages, apply changes to the corresponding file in [docs folder](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/docs).
|
||||||
- If your changes contain an image then see [images in documentation](https://docs.victoriametrics.com/#images-in-documentation).
|
- If your changes contain an image then see [images in documentation](https://docs.victoriametrics.com/#images-in-documentation).
|
||||||
- Once changes are made, execute the command below to finalize and sync the changes:
|
- Once changes are made, execute the command below to finalize and sync the changes:
|
||||||
```sh
|
|
||||||
make docs-sync
|
```sh
|
||||||
```
|
make docs-sync
|
||||||
|
```
|
||||||
|
|
||||||
- Create [a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
|
- Create [a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
|
||||||
with proposed changes and wait for it to be merged.
|
with proposed changes and wait for it to be merged.
|
||||||
|
|
||||||
Requirements for changes to docs:
|
Requirements for changes to docs:
|
||||||
|
|
||||||
- Keep backward compatibility of existing links. Avoid changing anchors or deleting pages as they could have been
|
- Keep backward compatibility of existing links. Avoid changing anchors or deleting pages as they could have been
|
||||||
used or posted in other docs, GitHub issues, stackoverlow answers, etc.
|
used or posted in other docs, GitHub issues, stackoverlow answers, etc.
|
||||||
- Keep docs simple. Try using as simple wording as possible.
|
- Keep docs clear, concise and simple. Try using as simple wording as possible, without loosing the clarity.
|
||||||
- Keep docs consistent. When modifying existing docs, verify that other places referencing to this doc are still relevant.
|
- Keep docs consistent. When modifying existing docs, verify that other places referencing to this doc are still relevant.
|
||||||
- Prefer improving the existing docs instead of adding new ones.
|
- Prefer improving the existing docs instead of adding new ones.
|
||||||
- Use absolute links.
|
- Use absolute links. This simplifies moving docs between different files.
|
||||||
|
|
||||||
|
Priodically run `make spellcheck` - this command detects spelling errors at `docs/` folder. Please fix the found spelling errors
|
||||||
|
and commit the fixes in a separate commit.
|
||||||
|
|
||||||
### Images in documentation
|
### Images in documentation
|
||||||
|
|
||||||
|
@ -2654,24 +2654,30 @@ It is built from `*.md` files located in [docs](https://github.com/VictoriaMetri
|
|||||||
and gets automatically updated once changes are merged to [master](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master) branch.
|
and gets automatically updated once changes are merged to [master](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master) branch.
|
||||||
To update the documentation follow the steps below:
|
To update the documentation follow the steps below:
|
||||||
- [Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)
|
- [Fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)
|
||||||
VictoriaMetrics repo and apply changes to the docs:
|
VictoriaMetrics repo and apply changes to the docs:
|
||||||
- To update [the main page](https://docs.victoriametrics.com/) modify [this file](https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/README.md).
|
- To update [the main page](https://docs.victoriametrics.com/) modify [this file](https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/README.md).
|
||||||
- To update other pages, apply changes to the corresponding file in [docs folder](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/docs).
|
- To update other pages, apply changes to the corresponding file in [docs folder](https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/docs).
|
||||||
- If your changes contain an image then see [images in documentation](https://docs.victoriametrics.com/#images-in-documentation).
|
- If your changes contain an image then see [images in documentation](https://docs.victoriametrics.com/#images-in-documentation).
|
||||||
- Once changes are made, execute the command below to finalize and sync the changes:
|
- Once changes are made, execute the command below to finalize and sync the changes:
|
||||||
```sh
|
|
||||||
make docs-sync
|
```sh
|
||||||
```
|
make docs-sync
|
||||||
|
```
|
||||||
|
|
||||||
- Create [a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
|
- Create [a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
|
||||||
with proposed changes and wait for it to be merged.
|
with proposed changes and wait for it to be merged.
|
||||||
|
|
||||||
Requirements for changes to docs:
|
Requirements for changes to docs:
|
||||||
|
|
||||||
- Keep backward compatibility of existing links. Avoid changing anchors or deleting pages as they could have been
|
- Keep backward compatibility of existing links. Avoid changing anchors or deleting pages as they could have been
|
||||||
used or posted in other docs, GitHub issues, stackoverlow answers, etc.
|
used or posted in other docs, GitHub issues, stackoverlow answers, etc.
|
||||||
- Keep docs simple. Try using as simple wording as possible.
|
- Keep docs clear, concise and simple. Try using as simple wording as possible, without loosing the clarity.
|
||||||
- Keep docs consistent. When modifying existing docs, verify that other places referencing to this doc are still relevant.
|
- Keep docs consistent. When modifying existing docs, verify that other places referencing to this doc are still relevant.
|
||||||
- Prefer improving the existing docs instead of adding new ones.
|
- Prefer improving the existing docs instead of adding new ones.
|
||||||
- Use absolute links.
|
- Use absolute links. This simplifies moving docs between different files.
|
||||||
|
|
||||||
|
Priodically run `make spellcheck` - this command detects spelling errors at `docs/` folder. Please fix the found spelling errors
|
||||||
|
and commit the fixes in a separate commit.
|
||||||
|
|
||||||
### Images in documentation
|
### Images in documentation
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user