Improve Alexa Smart Home Documentation.#11851
Conversation
There was a problem hiding this comment.
I've stopped reviewing halfway, because it is a huge PR and contains a lot of the same things.
Please:
- Ensure you have an empty line after each heading.
- Use common markdown, avoid the use of HTML. (The images are allowed).
- 1 empty line for separation is enough, more don't have a function in Markdown.
- Lines do not need whitespace at the end.
- Ensure headings are in level order.
- Try to avoid
easy,simple,simpler,easiest,simply, they can be received condescending by the reader.
|
|
||
| ## Amazon Alexa Smart Home | ||
|
|
||
| ##### Steps to Integrate an Amazon Alexa Smart Home Skill with Home Assistant |
There was a problem hiding this comment.
Header level if of, compared to the parent heading level.
Make a new line after adding a header.
There was a problem hiding this comment.
This is the only one I was unsure of exactly what you were asking. I assume you were saying "header level is off". I ended up removing this header since it's the same as the H1 for the page and restructured the headers for the entire page. Please Confirm.
Co-Authored-By: Franck Nijhof <frenck@frenck.nl>
Utterance formatting updates.
frenck
left a comment
There was a problem hiding this comment.
A couple of commas and those type of things.
Furthermore, darn m8! Nice job! 👍
Add utterance. Grammar fixes.
Co-Authored-By: Franck Nijhof <frenck@frenck.nl>
|
Thanks for the help @frenck you are a machine 🤖. |
|
Thanks for the PR @ochlocracy! 👍 |
Proposed change
added styling for thekbdandsampHTML tags for voice input.Utterance styling
The currentcodetag does not provide a styling that resonates with voice input/output. Usingkbdandsampis semantically correct for this situation but the default browser style lacks the representation of voice. I reviewed how Google Assistant, and Amazon styled voice input in their documentation and created a style for situations semantically correct for voice input. e.g.ptags insidekbdtags. I welcome comments, as it's something that can be used through the HA documentation.Type of change
currentbranch).currentbranch).nextbranch).nextbranch).Additional information
Checklist
currentbranch.nextbranch.