Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Doc updates #1980

Draft
wants to merge 4 commits into
base: master
Choose a base branch
from
Draft

Doc updates #1980

wants to merge 4 commits into from

Conversation

3tilley
Copy link

@3tilley 3tilley commented Nov 17, 2023

Proposed change

Add more information to documentation

Type of change

I've just been through the process of creating my own addon, and these are some things I've learnt and I think would help newcomers. Please check that what I have written is correct!

  • Document existing features within Home Assistant
  • Document new or changing features which there is an existing pull request elsewhere
  • Spelling or grammatical corrections, or rewording for improved clarity
  • Changes to the backend of this documentation
  • Removed stale or deprecated documentation

Additional information

  • This PR fixes or closes issue: fixes #
  • Link to relevant existing code or pull request:

Copy link
Contributor

@davet2001 davet2001 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for preparing the submission!
Minor corrections spotted.

docs/add-ons/configuration.md Outdated Show resolved Hide resolved
docs/add-ons/configuration.md Outdated Show resolved Hide resolved
@home-assistant home-assistant bot marked this pull request as draft April 6, 2024 22:24
@home-assistant
Copy link

home-assistant bot commented Apr 6, 2024

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

3tilley and others added 2 commits April 8, 2024 15:02
Co-authored-by: Dave T <17680170+davet2001@users.noreply.github.com>
Co-authored-by: Dave T <17680170+davet2001@users.noreply.github.com>
@3tilley
Copy link
Author

3tilley commented Apr 8, 2024

I've made those changes, thanks for having a look!

@3tilley 3tilley marked this pull request as ready for review April 8, 2024 14:04
@home-assistant home-assistant bot requested a review from davet2001 April 8, 2024 14:04
@@ -57,6 +57,8 @@ then there will be a variable `TARGET` containing `beer` in the environment of y

All add-ons are based on the latest Alpine Linux image. Home Assistant will automatically substitute the right base image based on the machine architecture. Add `tzdata` if you need to run in a different timezone. `tzdata` Is is already added to our base images.

Images can be found [here](https://github.com/home-assistant/docker-base/blob/master/README.md). To test your add-on, you can build with these locally, e.g. on a 64-bit desktop `docker build --build-arg BUILD_FROM=ghcr.io/home-assistant/amd64-base`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think what you are adding is already covered by an existing page.

https://developers.home-assistant.io/docs/add-ons/testing#local-build

So it might be better to link to it, or at least make reference to it.

@@ -61,7 +61,7 @@ arch:

### The `run.sh` file

This is the script that will run when your add-on starts.
This is the script that will run when your add-on starts. It runs in `bashio` which is a Home Assistant shell that adds a few features. Build from the base Home Assistant images to run your containers locally.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This is the script that will run when your add-on starts. It runs in `bashio` which is a Home Assistant shell that adds a few features. Build from the base Home Assistant images to run your containers locally.
This is the script that will run when your add-on starts. It runs in `bashio` which is a Home Assistant shell that adds a few features.

Is the last part of the addition necessary?

@home-assistant home-assistant bot marked this pull request as draft April 30, 2024 06:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants