Use _ prefix instead of _real suffix on variables

On the whole, the style in manifests for variables that have been
modified in a local scope and saved to a new variable name have shifted
from using `$foo` -> `$foo_real` to using `$foo` -> `$_foo` due to the
shortness of the form and semantic implications that `$_*` is not
neccessarily human-friendly.
Copy edited
Fix missing protocol in URI for JIRA
Change protocol from HTTP to HTTPS to make the installation more secure
Dupe 3.1 dir to create 3.2 dir. Also, PE 1873: edit maintain_console to change default rake task to reindex only
(doc) Fix variable name typo in custom function ruby exmple

There's no other reference to 'vals' and 'args' seems appropriate
so this was likely a typo.
Use HTTPS instead of HTTP for {apt,yum}.puppetlabs.com (inc. enterprise)
Added tip for DOC-101
PDB-264 Prepare documentation for PuppetDB 1.6.0rc1

This commit prepares the documentation site for the upcoming 1.6.0rc1 release
of PuppetDB.

This slightly differs from our normal approach, in that we normally do not do
an RC release. This time, we are doing all the normal work for a feature
release but modifying the index change so that the pre-release is categorized
accordingly, and the 1.5 documentation stays prominent until we do the final.

When we do the final release, the link for 'latest' and the index update will
be required.

Signed-off-by: Ken Barber <ken@bob.sh>
Fix DOC-421

Broken links should no longer be generated for non-versioned documents.
Merge pull request #247 from hunner/local_scope_vars

Use _ prefix instead of _real suffix on variables
Merge pull request #264 from kbarber/ticket/master/PDB-264_prepare_for_puppetdb_16

PDB-264 Prepare documentation for PuppetDB 1.6.0rc1
Merge pull request #263 from shrug/master

(maint) Move Puppet 2.6 and 2.7 under "Unsupported Releases" in the Release Notes
Merge pull request #259 from dveeden/master

Two fixes for protocols in URI
Merge pull request #261 from rwstauner/fix/master/custom-function-example-var-name

(doc) Fix variable name typo in custom function ruby exmple
Fix DOC-92

The class is now declared in a way that is consistent with the rest of
the Learning Puppet exercises.
Fix typo in PuppetDB 1.6 index

I've inadvertently introduced a capital T somehow into the index, this patch
fixes that.

Signed-off-by: Ken Barber <ken@bob.sh>
Merge pull request #265 from kbarber/maint/master/typo_in_puppetdb16_index

Fix typo in PuppetDB 1.6 index
Clarify proviso for Windows packages

Technically you can manage packages on Windows without specifying the
source attribute, but not if you use the windows provider.
update reporting guide Puppet 3.x link to mention formats 3 and 4