better error description  on [ -w  ]
add documentation and examples strings; yes ansible-docs won't use this as this is a bash module, but it still is the best place to document this