(FM-8079) Final touches

* clarify that, yes, bulbs are needed, too
* remove duplicate java and emulator install instructions
* update "Add a new transport" section to use released pdk feature

Author: DavidS

docs/hands-on-lab/01-installing-prereqs.md

@@ -4,7 +4,7 @@ To start, install Puppet Development Kit (PDK), which provides all the necessary
 
 1. [Download PDK](https://puppet.com/download-puppet-development-kit) on your platform of choice.
 
-2. If you do not have a Philips HUE hub available, you can download the [Hue-Emulator](https://github.com/SteveyO/Hue-Emulator/raw/master/HueEmulator-v0.8.jar). You need to have Java installed to run this.
+2. If you do not have a Philips HUE hub and bulbs available, you can download the [Hue-Emulator](https://github.com/SteveyO/Hue-Emulator/raw/master/HueEmulator-v0.8.jar). You need to have Java installed to run this.
 
 3. To edit code, we recommend the cross-platform editor [VSCode](https://code.visualstudio.com/download), with the [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) and [Puppet](https://marketplace.visualstudio.com/items?itemName=jpogran.puppet-vscode) extensions. There are lots of other extensions that can help you with your development workflow.
 

docs/hands-on-lab/02-connecting-to-the-lightbulbs.md

@@ -4,9 +4,7 @@ There are no technical restrictions on the kinds of remote devices or APIs you c
 
 ## Hue Emulator
 
-Download the [HueEmulator-v0.8.jar](https://github.com/SteveyO/Hue-Emulator/blob/master/HueEmulator-v0.8.jar) from [SteveyO/Hue-Emulator](https://github.com/SteveyO/Hue-Emulator).
-
-To run the Hue Emulator, you need to have a Java Runtime installed. Use `java -jar` with the emulator's filename to run it, for example:
+Use `java -jar` with the emulator's filename to run it, for example:
 
 ```
 david@davids:~$ java -jar ~/Downloads/HueEmulator-v0.8.jar

docs/hands-on-lab/04-adding-a-new-transport.md

@@ -1,17 +1,9 @@
 # Add a new transport
 
-[Eventually](https://github.com/puppetlabs/pdk/pull/666) there will be a `pdk new transport` command. For now, you'll need to copy the files below.
+Starting with PDK 1.12.0 there is the `pdk new transport` command, that you can use to create the base files for your new transport:
 
-Copy the files from [this directory](./04-adding-a-new-transport/) into your new module:
-
-* .sync.yml
-* lib/puppet/transport/hue.rb
-* lib/puppet/transport/schema/hue.rb
-* lib/puppet/util/network_device/hue/device.rb
-* spec/unit/puppet/transport/hue_spec.rb
-* spec/unit/puppet/transport/schema/hue_spec.rb
-
-Run `pdk update --force` to enable a few future defaults that are required for these templates:
+Copy the [.sync.yml](./04-adding-a-new-transport/.sync.yml) into your new module, and run `pdk update --force` to enable a few future
+defaults that are required for this command:
 
 ```
 david@davids:~/tmp/hue$ pdk update --force
@@ -34,6 +26,18 @@ You can find a report of differences in update_report.txt.
 david@davids:~/tmp/hue$
 ```
 
+Then, create the actual transport:
+
+```
+david@davids:~/tmp/hue$ pdk new transport hue
+pdk (INFO): Creating '/home/david/tmp/hue/lib/puppet/transport/hue.rb' from template.
+pdk (INFO): Creating '/home/david/tmp/hue/lib/puppet/transport/schema/hue.rb' from template.
+pdk (INFO): Creating '/home/david/tmp/hue/lib/puppet/util/network_device/hue/device.rb' from template.
+pdk (INFO): Creating '/home/david/tmp/hue/spec/unit/puppet/transport/hue_spec.rb' from template.
+pdk (INFO): Creating '/home/david/tmp/hue/spec/unit/puppet/transport/schema/hue_spec.rb' from template.
+david@davids:~/tmp/hue$
+```
+
 ## Checkpoint
 
 To validate your new module and transport, run `pdk validate --parallel` and `pdk test unit`:
@@ -62,7 +66,7 @@ Run options: exclude {:bolt=>true}
 david@davids:~/tmp/hue$
 ```
 
-If you're working with a version control system, now would be a good time to make your first commit and store the boilerplate code, and then you can revisit the changes you made later. For example: 
+If you're working with a version control system, now would be a good time to make your first commit and store the boilerplate code, and then you can revisit the changes you made later. For example:
 
 ```
 david@davids:~/tmp/hue$ git init