Improved documentation for Ubuntu15+ installations

[stephlocke]

As I've gone through the process as a n00b I identified various points where there were issues (like the wget going to wrong dir) or where there it just assumed you were comfortable with linux.

I added a TL;DR so that people who were really expert could get going quickly.

Hopefully, these docs are considered an improvement. If they are, I'm happy to do a similar modification to the Ubuntu14 notes.

[ahmetb]

thanks for this I'll review.

[ahmetb]

this is not quite accurate, we have a single file.

[stephlocke]

Sorry, left the remnant in - should be changed to "Extract the files so we can get the relevant config files we need later"

[ahmetb]

it just assumed you were comfortable with linux.

I think we have a bit of disagreement. This product is a bit intended for Linux-savvy people as it is Linux-only a well as an advanced tool. I'm not very big fan of explaining every single bit of detail of the steps and it appears like it gets kind of harder to follow for the advanced users.

I'll add our docs expert @squillace to comment.

[ahmetb]

I think this is wgettable as well from the file's raw.github.com URL. I don't think the users should be downloading the entire tar.gz.

Also, if we document it like this, we'll be have to support this library structure (or docs will get broken).

[stephlocke]

I think it's important users know where to get the files - not least because they might end up with the wrong copies from the init folder. If you think that it's easier for them to get the file from the git dirs that's fine - although you'd still have an issue with restricted folder structures?

[ahmetb]

it's just generally the instructions did not seem complicated to me at all (perhaps because I'm the author of the project of course). However I think we can just clarify the file paths in the original version, but I'm a bit against providing full wget links etc. That seemed a bit far too verbose.

[stephlocke]

Fair enough - can we simply refer to the directory they should be in ie ../contrib/init/systemd?

[ahmetb]

@stephlocke yeah

[ahmetb]

I'm still a bit against downloading tar.gz. People can just download the .service & .default files individually from the GitHub repo?

[ahmetb]

well, they don't have it on their disk at this point. so maybe we should point them to the file with something like:

- download [azurefile-dockervolumedriver.default](../path/to/azurefile-dockervolumedriver.default) file first

[ahmetb]

these can be briefly done as mkdir -p /etc/systemd/system

[ahmetb]

looks way better now. thanks! 👍 🎊

[stephlocke]

On the level the docs should be pitched at....
Docker is a hot topic and there's a lot of different pressures for people to use it. Most of those people do not have the time to first get fully up to speed with Linux - most are from "Microsoft shops, and only Microsoft". There's even more incentive for these people to try to keep it in Azure so they still retain some of that Microsoft aegis. I think you'll see more n00bs in future as a consequence. I think you should be lowering the barriers to entry as much as possible - it's the Microsoft way (in my eyes). Obviously, you don't have to accept my PR though or my opinions on documentation!

cc @squillace

[ahmetb]

I think there is a good balance between totally n00b docs and an advanced one. This is way better now. Thanks for your contribution. 🎆

[stephlocke]

My pleasure, apologies for being hassle!