Finish Getting Started changes.

dlech · dlech · commit ec04430bdb2a · 2015-12-28T21:50:44.000-06:00
Fixed feedback items from @WasabiFan
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -33,8 +33,8 @@ First, here are the things you need before starting:
 <span class="glyphicon glyphicon-alert"></span>
 The instructions on this page only apply to releases dated December
 2015 or later. Older releases are no longer supported. There are many major changes
-in this release, so if something seems broken or the documentation seems incorrect,
-please [open an issue on GitHub](../../support).
+in the December release, so if something seems broken or the documentation seems incorrect,
+please [open an issue on GitHub]({{ site.github.url }}/support).
 {:class="alert alert-warning"}
 
 ## Step 1: Download the latest ev3dev image file
@@ -90,7 +90,7 @@ LEDs indicate disk (SD card) activity.
 **Note:** If you are using Raspberry Pi hardware without a screen, just wait for
 the Activity LED to stop flashing, then go to the next step.
 
-After about one minutes, the screen will go blank. This happens on the first boot
+After about one minute, the screen will go blank. This happens on the first boot
 only. The first boot takes longer than subsequent boots because the EV3
 has to create a unique SSH host ids and take care of a few other housekeeping
 items. After another minute or two, you will see the *brickman loading...* screen.
@@ -105,118 +105,88 @@ data may be lost. Keep in mind, that is may take a much longer time from 8V to
 6.5V than from 6.5V down to 5V!
 
 <div class="panel panel-info">
-    <div class="panel-heading">
-        Troubleshooting tips if your EV3 won't boot
-    </div>
-    <div class="panel-body">
-        <ul>
-            <li>Make sure nothing is plugged into the EV3 (USB/sensors/motors/etc.)</li>
-            <li>Try writing the image to the SD card again.</li>
-            <li>You may have a bad/incompatible SD card - try a different SD card.</li>
-            <li>Check the condition of the EV3 batteries.</li>
-        </ul>
-    </div>
+<div class="panel-heading">
+<span class="glyphicon glyphicon-info-sign" aria-hidden="true"></span>
+Troubleshooting tips if your EV3 won't boot
+</div>
+<div class="panel-body" markdown="1">
+* Make sure nothing is plugged into the EV3 (USB/sensors/motors/etc.)
+* Try writing the image to the SD card again.
+* You may have a bad/incompatible SD card - try a different SD card.
+* Check the condition of the EV3 batteries.
+</div>
 </div>
 
 ## Step 4: Setup a network connection
 
 There are lots of choices here. Your choice depends on what type of connection
 you want to use and on the OS of your host computer, so pick the one that applies:
 
-* Ethernet over USB (just requires the USB cable that comes with the EV3)
+* __Ethernet over USB__ (just requires the USB cable that comes with the EV3)
     * [Connecting to the Internet](../tutorials/connecting-to-the-internet-via-usb) tutorial
-* USB Ethernet dongle (as in the kind with an RJ45 connector)
-    * If your network has a DHCP server, this will "just work". See (non-existent) brickman
-      docs for more info.
-* USB WiFi Dongle
+* __USB Ethernet dongle__ (as in the kind with an RJ45 connector)
+    * If your network has a DHCP server, this will "just work".
+* __USB WiFi Dongle__
     * Hopefully you can figure it out. I'm putting off writing detailed docs
       until brickman is a bit more stable.
-* Bluetooth
+* __Bluetooth__
     * Note: Bluetooth may not work on the first boot. Please reboot if you see "???"
        after you power on Bluetooth.
     * [Connecting to the Internet](../tutorials/connecting-to-the-internet-via-bluetooth) tutorial
 
-**Note:** For Raspberry Pi you must use the wired Ethernet port to connect for the
-first time. The default host name is `ev3dev-rpi` or `ev3dev-rpi2` depending
-on which model you have. You can setup additional connections using the
+<span class="glyphicon glyphicon-info-sign" aria-hidden="true"></span>
+For Raspberry Pi with no display, you must use the wired Ethernet port
+to connect for the first time. You can setup additional connections using the
 `connmanctl` command.
+{: class="alert alert-info"}
 
 ## Step 5: First things to do with ev3dev
 
 Here are some suggestions of some things you should do to get ev3dev setup.
+These commands are run on the EV3 in a terminal window. See the networking
+tutorials above if you don't know how to open terminal window and connect via SSH.
 
-### Change your root password
+### Change your password
 
-The default root password is r00tme - those are zeros, not "Ohs".
+The default password is `ev3dev`.
 
-    root@ev3dev:~# passwd
+    robot@ev3dev:~$ passwd
     Enter new UNIX password: 
     Retype new UNIX password: 
     passwd: password updated successfully
 
-### Set up a new user
-
-Replace `user` with your actual user name and `First Last` with your real name
-(if you want it on the EV3 - you can leave it blank too). Don't miss the
-command to assign groups hiding at the end.
-
-    root@ev3dev:~# adduser user
-    Adding user `user' ...
-    Adding new group `user' (1001) ...
-    Adding new user `user' (1001) with group `user' ...
-    Creating home directory `/home/user' ...
-    Copying files from `/etc/skel' ...
-    Enter new UNIX password: 
-    Retype new UNIX password: 
-    passwd: password updated successfully
-    Changing the user information for user
-    Enter the new value, or press ENTER for the default
-    	Full Name []: First Last
-    	Room Number []:    
-    	Work Phone []: 
-    	Home Phone []: 
-    	Other []: 
-    Is the information correct? [Y/n] y
-    root@ev3dev:~# usermod -a -G sudo,ev3dev,plugdev,audio,video,input,bluetooth,i2c user
-
 ### Set the time zone
 
-    root@ev3dev:~# dpkg-reconfigure tzdata
+    robot@ev3dev:~$ sudo dpkg-reconfigure tzdata
 
 Then just follow the instructions on the screen.
 
-**NOTE:** The EV3 does not have a battery backup for the realtime clock.
+<span class="glyphicon glyphicon-info-sign" aria-hidden="true"></span>
+The EV3 and Raspberry Pi do not have a battery backup for the realtime clock.
 Whenever you remove the batteries, the clock will be reset. If the EV3 is
 connected to the Internet, the clock will be automatically set via NTP,
 otherwise, you can manually set the date/time with the `date` command.
-
+{: class="alert alert-info"}
 
 ### Set the locale
 
 You can skip this if en-US is OK.
 
-    root@ev3dev:~# dpkg-reconfigure locales
+    robot@ev3dev:~$ sudo dpkg-reconfigure locales
 
 ### Update packages
 
-<div class="alert alert-danger">
-    <span class="glyphicon glyphicon-exclamation-sign"></span>
-    If you are a beginner with Linux and/or Debian, you should skip updating packages
-    for now. We are working on some major changes and things will be inconsisent with the
-    documentation if you upgrade.
-</div>
-
 Make sure your EV3 is connected to the Internet first. 
 Updating the packages for the first time will take minutes.
 The duration depends on the speed class of the SD card and on the updates involved.
 
-    root@ev3dev:~# apt-get update
-    root@ev3dev:~# apt-get upgrade
-    root@ev3dev:~# apt-get dist-upgrade
+    robot@ev3dev:~$ sudo apt-get update
+    robot@ev3dev:~$ sudo apt-get upgrade
+    robot@ev3dev:~$ sudo apt-get dist-upgrade
 
 If a new kernel package is installed, you will need to reboot.
 
-    root@ev3dev:~# reboot
+    robot@ev3dev:~$ sudo reboot
 
 ## Step 6: Do something awesome
 
@@ -254,7 +224,7 @@ hang of it, you can even write your own interface library and have it listed her
 When you are ready to wish your EV3 goodnight, turn if off by pressing the
 *back* button from the main menu in brickman or pressing and holding the *back*
 button from any screen in brickman. This will open a dialog where you can select
-*Power Off* to turn off the EV3.
+*Power Off* to turn off the EV3. (Running `sudo poweroff` in a terminal works too.)
 
 [microSD]: https://en.wikipedia.org/wiki/Secure_Digital#SD
 [microSDHC]: https://en.wikipedia.org/wiki/Secure_Digital#SDHC
diff --git a/docs/tutorials/connecting-to-the-internet-via-bluetooth.md b/docs/tutorials/connecting-to-the-internet-via-bluetooth.md
@@ -3,15 +3,17 @@ title: Connecting to the Internet via Bluetooth
 subject: Networking
 ---
 
-__Note:__ If you do not need to access the Internet from the EV3 brick, consider
+<span class="glyphicon glyphicon-info-sign" aria-hidden="true"></span>
+If you do not need to access the Internet from the EV3 brick, consider
 using [tethering] instead.
+{: .alert .alert-info}
 
 [tethering]: /docs/tutorials/using-bluetooth-tethering
 
----
-
-These instructions are for [brickman v0.5.0](http://www.ev3dev.org/news/2015/02/24/Package-Release/).
+<span class="glyphicon glyphicon-warning-sign" aria-hidden="true"></span>
+These instructions are for [brickman v0.7.0](http://www.ev3dev.org/news/2015/12/15/Package-Release/).
 If you are using an older version, please upgrade.
+{: .alert .alert-warning}
 
 *   {: tab="Android"}Note: These instructions were written using Android 4.1.2
     but should work for other versions as well.
diff --git a/docs/tutorials/connecting-to-the-internet-via-usb.md b/docs/tutorials/connecting-to-the-internet-via-usb.md
@@ -11,9 +11,9 @@ using [tethering] instead.
 [tethering]: /docs/tutorials/using-usb-tethering
 
 <span class="glyphicon glyphicon-warning-sign" aria-hidden="true"></span>
-These instructions are for [brickman v0.7.1](http://www.ev3dev.org/news/2015/02/24/Package-Release/).
+These instructions are for [brickman v0.7.0](http://www.ev3dev.org/news/2015/12/15/Package-Release/).
 If you are using an older version, please upgrade.
-{: class="alert alert-warning"}
+{: .alert .alert-warning}
 
 *   {: tab="Mac OSX"}<span class="glyphicon glyphicon-warning-sign" aria-hidden="true"></span>
     If you are using OS X version 10.11, this won't work. Apple broke the USB/CDC
@@ -42,11 +42,11 @@ If you are using an older version, please upgrade.
 
     3.  Click *Apply* to save your changes. After a short time, the ev3dev entry
         (or whatever you named it) should show connected and have a Self-Assigned
-        IP address
+        IP address.
 
         {% include screenshot.html source="/images/osx/10.9/CDC-Connected.png" %}
 
-    4.  To share our Internet connection with the EV3. Go back to *System
+    4.  To share our Internet connection with the EV3, go back to *System
         Preferences* and select *Sharing*.
 
         {% include screenshot.html source="/images/osx/10.9/SystemPreferencesSharing.png" %}
@@ -272,6 +272,13 @@ If you are using an older version, please upgrade.
         {% include screenshot.html source="/images/windows/8/local-area-connection-properties-sharing-with-extra-selection.png" %}
         {: class="alert alert-info"}
 
+        <span class="glyphicon glyphicon-warning-sign" aria-hidden="true"></span>
+        Windows Internet Connection Sharing is temperamental. Sometimes it just
+        stops working for no reason. If this happens, just turn it off (by unchecking
+        *Allow other...* and clicking *OK*) and then turn it back on. It should
+        start working again.
+        {: class="alert alert-warning"}
+
     10. Click *OK* when you are done and close the status window as well. Windows
         will automatically reconfigure your other network connections.
 
diff --git a/images/brickman/shutdown-menu.png b/images/brickman/shutdown-menu.png
diff --git a/stylesheets/bootstrap-extensions.css b/stylesheets/bootstrap-extensions.css
@@ -128,6 +128,14 @@ h1.panel-title {
     max-width: 350px;
 }
 
+.inline-screenshot.pull-right {
+    margin-left: 20px;
+}
+
+.inline-screenshot.pull-left {
+    margin-right: 20px;
+}
+
 sup[id]:before {
     display: inline-block;
 }

Original file line number	Diff line number	Diff line change
`@@ -128,6 +128,14 @@ h1.panel-title {`
`128`	`128`	`max-width: 350px;`
`129`	`129`	`}`
`130`	`130`
	`131`	`+.inline-screenshot.pull-right {`
	`132`	`+ margin-left: 20px;`
	`133`	`+}`
	`134`	`+`
	`135`	`+.inline-screenshot.pull-left {`
	`136`	`+ margin-right: 20px;`
	`137`	`+}`
	`138`	`+`
`131`	`139`	`sup[id]:before {`
`132`	`140`	`display: inline-block;`
`133`	`141`	`}`