📚 Webterminal

docs/python.md

@@ -21,6 +21,7 @@ If you have installed additional components directly to `/srv/homeassistant/`
 like `libcec` thoese will need to be reinstalled.
 
 ***
+
 This script was originally contributed by [@Ludeeus][ludeeus].
 With inspiration from [blog.ceard.tech][blog].
 

docs/samba.md

@@ -1,4 +1,4 @@
-## Samba
+# Samba
 
 After this script has been run, the configuration directory used by
 Home Assistant is available over Samba and can be accessed from example
@@ -33,3 +33,4 @@ This script was originally contributed by [@Landrash][landrash].
 
 <!--- Links --->
 [landrash]: https://github.com/Landrash
+[repo]: https://github.com/home-assistant/hassbian-scripts/pulls

docs/webterminal.md

@@ -1,17 +1,22 @@
-## Description
-This script installs an web terminal called 'shellinabox' to your system that give you SSH access in your web browser.
+# Webterminal
+
+This script installs an web terminal called 'shellinabox' to your system that
+give you SSH access in your web browser.
 
 ## Installation
-```
-$ sudo hassbian-config install webterminal
+
+```bash
+sudo hassbian-config install webterminal
 ```
 
 ## Upgrade
+
 No script available, maybe you could write one?  
-If so, add an PR here when you are done:\
-[homeassistant/hassbian-scripts](https://github.com/home-assistant/hassbian-scripts/pulls)
+If so, add an PR here when you are done:  
+[homeassistant/hassbian-scripts][repo]
 
 ## Additional info
+
 Description | Command/value
 :--- | :---
 Running as: | root
@@ -21,9 +26,9 @@ Start service: | `sudo systemctl start shellinabox.service`
 Stop service: | `sudo systemctl stop shellinabox.service`
 Restart service: |`sudo systemctl restart shellinabox.service`
 Service status: |`sudo systemctl status shellinabox.service`
-|
 
 Example config for Home-Assistant:
+
 ```yaml
 panel_iframe:
   web_terminal:
@@ -32,16 +37,26 @@ panel_iframe:
     url: 'http://192.168.1.2:4200'
 ```
 
-#### Notes for SSL
-If you enable the use of existing Let's Encrypt certificates you need to open ports in your firewall to use them.
+### Notes for SSL
+
+If you enable the use of existing Let's Encrypt certificates you need to open
+ports in your firewall to use them.
+
+If SSL is used the panel_iframe has to use the same domain name as the one
+issued with your certificate.
 
-If SSL is used the panel_iframe has to use the same domain name as the one issued with your certificate.
 ```yaml
 panel_iframe:
   web_terminal:
     title: 'Web terminal'
     icon: mdi:console
     url: 'https://yourdomain.duckdns.org:4200'
 ```
+
 ***
-This script was originally contributed by [@Ludeeus](https://github.com/ludeeus).
+
+This script was originally contributed by [@Ludeeus][ludeeus].
+
+<!--- Links --->
+[ludeeus]: https://github.com/ludeeus
+[repo]: https://github.com/home-assistant/hassbian-scripts/pulls