Skip to content

Commit d63a7dc

Browse files
Lots of typo fixes and grammar tweaks (#581)
* Update documentation.md * Update maintainer.md * Update translation.md * Update addons.md * Update download.md * Update private_repositories.md * Update issues.md * Update action.md * Update appdaemon.md * Update include.md * Update integration.md * Update plugin.md * Update python_script.md * Update remove.md * Update start.md * Update template.md * Update theme.md * Update basic.md * Update download.md * Update prerequisites.md * Update appdaemon.md * Update dashboard.md * Update theme.md * Update dashboard.md * Update diagnostics.md * Update hacs_update_broke_my_hacs.md * Update logs.md * Update logs.md * Update data.md * Update remove.md * Update update.md * Update maintainer.md * Update source/docs/publish/appdaemon.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/contribute/translation.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/publish/appdaemon.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/publish/include.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/publish/integration.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/publish/start.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/publish/theme.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/use/data.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/use/download/download.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/publish/include.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/contribute/translation.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/contribute/translation.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/docs/publish/python_script.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --------- Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
1 parent 1fe1e53 commit d63a7dc

30 files changed

+81
-82
lines changed

source/docs/contribute/documentation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ The documentation site for HACS is using [Markdown](https://daringfireball.net/p
1010
There are two ways of contributing to the documentation:
1111

1212
- Using the **Edit this page on GitHub** link at the bottom of every page.
13-
- Building the documentation locally, using a devcontainer.
13+
- Building the documentation locally using a devcontainer.
1414

1515
_All changes to the documentation should go against the `{{ config.remote_branch }}` branch._
1616
The repository for the documentation is hosted @ https://github.com/hacs/documentation
@@ -80,7 +80,7 @@ When adding a new screenshot to the documentation, follow these guidelines:
8080
- `name_of_the_screenshot/light.png`
8181
- `name_of_the_screenshot/dark.png`
8282
- Use underscores `_` to separate words
83-
- Use lower case characters
83+
- Use lowercase characters
8484
8585
## Creating links
8686

source/docs/contribute/maintainer.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ This page should contain:
88

99
- information about CI/bots/services.
1010
- How releases are handled.
11-
- How versions is handled.
11+
- How versions are handled.
1212

1313

1414

@@ -26,16 +26,16 @@ This applies to repositories that fall into these categories:
2626

2727
HACS is prepared to handle those, and this is the flow of it:
2828

29-
1. The repository is marked as dangerous/have security issues, by someone opening an issue in https://github.com/hacs/default repository using the "Flag" issue template.
30-
2. The issue is reviewed, if the repository is considered to be of a critical character:
29+
1. The repository is marked as dangerous/has security issues, by someone opening an issue in [the HACS repository](https://github.com/hacs/default) using the "Flag" issue template.
30+
2. The issue is reviewed if the repository is considered to be of a critical character:
3131
1. A PR is opened to add the repository to https://github.com/hacs/default/blob/master/critical
3232
2. That PR will have a description of why, and extra steps you need to take.
3333
3. When it's merged, HACS will know about it during the next scan (30min or Home Assistant restart.)
3434
3. HACS receives an updated [critical file](https://github.com/hacs/default/blob/master/critical).
3535

36-
### If the repository is download with HACS
36+
### If the repository is downloaded with HACS
3737

38-
1. The repository files is removed.
38+
1. The repository files are removed.
3939
2. The repository is removed from HACS.
4040
3. Home Assistant is restarted to make sure it's not loaded anymore.
4141
4. When Home Assistant starts up, you will have a `critical` log entry, and a persistent notification telling you to open the HACS panel.
@@ -47,8 +47,8 @@ If you click the "More info about this incident" button you will be taken to the
4747

4848
If you click the "Acknowledge" button, you will not see that message anymore.
4949

50-
### If the repository is not download with HACS
50+
### If the repository is not downloaded with HACS
5151

5252
1. The repository is removed from HACS.
5353

54-
_That's it, since it was not download, no further action from HACS is necessary_
54+
_That's it, since it was not downloaded, no further action from HACS is necessary_

source/docs/contribute/translation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ To help out with the translation of HACS you need an account on Lokalise, the ea
1212

1313
When you have created your account [click here to join the HACS project on Lokalise](https://lokalise.com/public/854515055f679055040b37.42677693/).
1414

15-
If you are unsure on how to proceed their documentation is really good, and you can [find that here](https:/.lokalise.com/en/). Or send me a message @ [discord](https://discord.gg/apgchf8) (username: `ludeeus#4212`)
15+
If you are unsure of how to proceed, their documentation is really good, and you can [find that here](https://lokalise.com/en/). Or send me a message @ [discord](https://discord.gg/apgchf8) (username: `ludeeus#4212`)
1616

1717
Before each release new translations are pulled from Lokalise, so if you have added something look for it in the next version of HACS.
1818

19-
If you add elements to the UI of HACS that needs translations, update the [`en.json`](https://github.com/hacs/frontend/blob/master/src/localize/languages/en.json) file, when your PR are merged those new keys will be added to Lokalise ready to be translated.
19+
If you add elements to the UI of HACS that need translations, update the [`en.json`](https://github.com/hacs/frontend/blob/master/src/localize/languages/en.json) file, when your PR is merged, those new keys will be added to Lokalise, ready to be translated.

source/docs/faq/addons.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,6 @@ description: 'NO, no, nope, this is not an add-on, and does not handle add-ons'
1111

1212
## The exception
1313

14-
With all rules, there will at sompoint exist exceptions.
14+
With all rules, there will be exceptions at some point.
1515

16-
For HACS and add-ons that is now the [Get HACS add-on](https://github.com/hacs/addons) that was made for Home Assistatnt Operating System and Supervised to simplify the initial download of HACS itself.
16+
For HACS and add-ons that is now the [Get HACS add-on](https://github.com/hacs/addons) that was made for Home Assistant Operating System and Supervised to simplify the initial download of HACS itself.

source/docs/faq/download.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@ id: download
33
title: "How does it work: Download"
44
description: "How does it work: Download"
55
---
6-
When you download an element, this is what's happening:
6+
When you download an element, this is what happens:
77

88
1. The local target directory (folder) is deleted.
99
1. A new local target directory is created.
1010
1. All expected files are downloaded to that directory.
11-
1. What kind of files are downloaded depends on the element type (integration, dashboard, template, etc.).
11+
1. What kind of files are downloaded depends on the element type (integration, dashboard, template, etc.).

source/docs/faq/private_repositories.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,4 @@ title: Private GitHub Repositories
55

66
Private GitHub repositories can not be used with HACS at all.
77

8-
HACS can only get information that is public.
8+
HACS can only get publicly available information.

source/docs/help/issues.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ even replaced the whole hacs folder with a fresh download
8787

8888
### Examples of good issues
8989

90-
_Good issues have too much text to extract it (some also have screenshots), but a few are linked below:_
90+
_Good issues have too much text to extract (some also have screenshots), but a few are linked below:_
9191

9292
- [https://github.com/hacs/integration/issues/452](https://github.com/hacs/integration/issues/452)
9393
- [https://github.com/hacs/integration/issues/470](https://github.com/hacs/integration/issues/470)

source/docs/publish/action.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,24 +7,24 @@ description: "Use GitHub Actions to validate your repository with HACS"
77
You can use GitHub actions to validate your repository with HACS.
88
This will make sure that your repository can be validated in HACS after changes to your repository or HACS itself.
99

10-
This action uses the exact same code as HACS to validate a repository.
10+
This action uses the same code as HACS to validate a repository.
1111

12-
The action have 3 run types:
12+
The action has 3 run types:
1313

1414
- For the [hacs/default repo](https://github.com/hacs/default) it is used to validate new default repositories.
1515
- If you use releases the latest release will be checked, if not the default branch will be checked.
16-
- If you have it set up for PR's in your repository, it will run against the fork/branch that made the PR.
17-
- If you have it set up for pushes, if will run against the branch you push to.
16+
- If you have it set up for PRs in your repository, it will run against the fork/branch that made the PR.
17+
- If you have it set up for pushes, it will run against the branch you push to.
1818

1919
The action itself lives [here](https://github.com/hacs/action) and you are free to inspect the code and/or make a PR to add changes.
2020

2121
To use it, follow these steps:
2222

2323
1. Go to your repository on GitHub
2424
1. Click on "Create new file"
25-
1. For filename, paste .github/workflows/validate.yaml
25+
1. For the filename, paste .github/workflows/validate.yaml
2626
1. Paste the following contents:
27-
1. Change the value of `category` key, this needs to be one of: `appdaemon`, `integration`, `plugin`:material-information-outline:{ title="Plugin is the old name for dashboard but it is still used in the backend" }, `python_script`, `template`, `theme`
27+
1. Change the value of the `category` key, this needs to be one of: `appdaemon`, `integration`, `plugin`:material-information-outline:{ title="Plugin is the old name for dashboard but it is still used in the backend" }, `python_script`, `template`, `theme`
2828

2929
```yaml title=".github/workflows/validate.yml"
3030
name: Validate
@@ -46,7 +46,7 @@ jobs:
4646
category: "CHANGE_ME!"
4747
```
4848
49-
This will run on every PR and push, and at midnight every day. And `workflow_dispatch` allows you to run the action on demand from the Actions tab.
49+
This will run on every PR and push and at midnight every day. And `workflow_dispatch` allows you to run the action on demand from the Actions tab.
5050

5151
!!! tip
5252
If you maintain an integration, you can also validate your integration with [hassfest](https://developers.home-assistant.io/blog/2020/04/16/hassfest).

source/docs/publish/appdaemon.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,12 @@ A template to use as a reference is [ad-hacs](https://github.com/ludeeus/ad-hacs
88

99
## Requirements
1010

11-
For an AppDaemon app repository to be valid these are the requirements:
11+
For an AppDaemon app repository to be valid, these are the requirements:
1212

1313
### Repository structure
1414

1515
- There is only one app (one directory under `ROOT_OF_THE_REPO/apps/`) pr. repository (if you have more, only the first one will be managed.)
16-
- The app (all the python files for it) are located under `ROOT_OF_THE_REPO/apps/APP_NAME/`
17-
- The app and all the python files for it are located under `ROOT_OF_THE_REPO/apps/APP_NAME/`
16+
- The app (all the Python files for it) are located under `ROOT_OF_THE_REPO/apps/APP_NAME/`
1817

1918
#### OK example:
2019

@@ -43,7 +42,7 @@ README.md
4342

4443
When downloading/upgrading it will scan the content in the latest release.
4544

46-
If there are multiple releases in the repository the user have some options to download a specific version.
45+
If there are multiple releases in the repository, the user has some options to download a specific version.
4746
The choices will be the last 5 releases and the default branch.
4847

4948
#### If there are no releases

source/docs/publish/include.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: Include default repositories
44
description: 'Include default repositories'
55
---
66

7-
As a developer you can now add your repository to be included in as a default repository in the store.
7+
As a developer, you can now add your repository to be included as a default repository in the store.
88

99
Only the owner of the repository or a major contributor to it can submit a PR to have it included as a default.
1010

@@ -19,9 +19,9 @@ Add both these actions to your own repository and make sure they pass:
1919
- https://github.com/home-assistant/actions#hassfest (only for integrations)
2020
- https://github.com/hacs/action
2121

22-
When all of this is covered, you can add it to repository type files in https://github.com/hacs/default
22+
When all of this is covered, you can add it to repository type files at [https://github.com/hacs/default](https://github.com/hacs/default)
2323

24-
In your fork of `hacs/default`, create a new branch for your changes from the `master`branch. Do **not** use the`master` branch directly for your changes.
24+
In your fork of `hacs/default`, create a new branch for your changes from the `master` branch. Do **not** use the `master` branch directly for your changes.
2525

2626
Your PR needs to be editable, so you can not submit it from an organization.
2727

@@ -34,13 +34,13 @@ When a PR for this is merged, it will show up in HACS after the first scheduled
3434
## CI Checks
3535

3636
When submitting a repository for the default repository a suite of CI checks will be run to ensure that the repository follows the requirements.
37-
All checks needs to pass for the repository to be included (unless something else are agreed on).
37+
All checks need to pass for the repository to be included (unless something else is agreed on).
3838

3939
### Check Brands
4040

4141
_Only applies to integrations._
4242

43-
This checks that the repository are added to https://github.com/home-assistant/brands
43+
This checks that the repository is added to [https://github.com/home-assistant/brands](https://github.com/home-assistant/brands)
4444

4545
### Check Manifest
4646

@@ -88,11 +88,11 @@ This checks general things about the repository like:
8888

8989
### Lint [jq]
9090

91-
This make sure that the files still are valid JSON.
91+
This makes sure that the files still are valid JSON.
9292

9393
### Lint [sorted]
9494

95-
This make sure that the files still are sorted correctly.
95+
This makes sure that the files still are sorted correctly.
9696

9797
## After Submitting
9898

0 commit comments

Comments
 (0)