amend documentation
amend documentation

- [x] mention ssh-agent auth socket issue on osx
- [x] document multi-stage option

ceejatec/docs,31z4/docs,jetty-project/docker-docs,docker-flink/docs,docker-solr/docs,31z4/docs,zendtech/docs,docker-library/docs,Lightstreamer/docs,dinogun/docs,ceejatec/docs,dmetzler/docker-library-docs,infosiftr/docker-library-docs,crate/docker-docs,Lightstreamer/docs,docker-library/docs,davidcurrie/docs,dinogun/docs,avoinea/docs,nats-io/docker-docs,dmetzler/docker-library-docs,Bonitasoft-Community/docker_docs,nats-io/docker-docs,odoo/docker-docs,zendtech/docs,Bonitasoft-Community/docker_docs,odoo/docker-docs,docker-flink/docs,docker-solr/docs,crate/docker-docs,avoinea/docs,infosiftr/docker-library-docs,jetty-project/docker-docs,tilosp-docker/library-docs,tilosp-docker/library-docs,davidcurrie/docs