Do not use os= in Config Reference

The Config Reference does not profile for the os variable and thus
all occurences of os=... are shown which leads to confusion. Add proper
wording for all examples.

Change-Id: I77c81b92e95d1b8737b507ea439a9622ebc3d6f1
Closes-Bug: #1232864
Add block store troubleshoot docs

This patch adds block storage troubleshooting documentation,
which superseeds the old documentation.

It's actually https://review.openstack.org/#/c/49972 - but that
patch became a rebase hell, hence the new one.

Change-Id: I37621e1bede368b57a5af5e33b2d131c7e28d488
Fix install guide based on testing under ubuntu

This patch fixes the install guide based on real testing under ubuntu

Change-Id: I26d52ece284b420f1da206ea7bf971f72eececa6
Improve openSUSE instructions, add debian to os profile

Document openSUSE network install
Add debian to os="ubuntu" as appropriate.

Change-Id: I81ea3c183e2d0d08f7351a457969acbb0a9806a6
Merge "Fix install guide based on testing under ubuntu"
Merge "Do not use os= in Config Reference"
Merge "Improve openSUSE instructions, add debian to os profile"
Merge "Add block store troubleshoot docs"