Update docs: provide guidance for named args
Update docs: provide guidance for named args

This fixes https://github.com/mesosphere/marathon/issues/1740

meln1k/marathon,mikejihbe/marathon,ramitsurana/marathon,cgvarela/marathon,titosand/marathon,HardikDR/marathon,cherrydocker/marathon-1,SivagnanamCiena/marathon,okuryu/marathon,HardikDR/marathon,sledigabel/marathon,ramitsurana/marathon,pugna0/marathon,cherrydocker/marathon-1,meln1k/marathon,lelezi/marathon,guenter/marathon,pgkelley4/marathon,Kosta-Github/marathon,meln1k/marathon,natemurthy/marathon,hangyan/marathon,Kosta-Github/marathon,ss75710541/marathon,bsideup/marathon,timcharper/marathon,manojlds/marathon,guenter/marathon,ayouwei/marathon,janisz/marathon,timcharper/marathon,janisz/marathon,pugna0/marathon,IanSaunders/marathon,yp-engineering/marathon,gsantovena/marathon,ayouwei/marathon,okuryu/marathon,meln1k/marathon,ramitsurana/marathon,vivekjuneja/marathon,lelezi/marathon,vivekjuneja/marathon,hangyan/marathon,cgvarela/marathon,MrMarvin/marathon,mesosphere/marathon,EasonYi/marathon,guenter/marathon,vivekjuneja/marathon,mesosphere/marathon,ss75710541/marathon,murat-lacework/marathon,mikejihbe/marathon,yp-engineering/marathon,SivagnanamCiena/marathon,EasonYi/marathon,guenter/marathon,titosand/marathon,rtward/marathon,gsantovena/marathon,gsantovena/marathon,sledigabel/marathon,IanSaunders/marathon,okuryu/marathon,lelezi/marathon,murat-lacework/marathon,pugna0/marathon,cgvarela/marathon,bsideup/marathon,sledigabel/marathon,rtward/marathon,natemurthy/marathon,SivagnanamCiena/marathon,MrMarvin/marathon,mesosphere/marathon,gsantovena/marathon,cherrydocker/marathon-1,hangyan/marathon,matsluni/marathon,natemurthy/marathon,pgkelley4/marathon,Caerostris/marathon,Caerostris/marathon,ayouwei/marathon,Caerostris/marathon,Yhgenomics/marathon,HardikDR/marathon,mesosphere/marathon,IanSaunders/marathon,EasonYi/marathon,guenter/marathon,rtward/marathon,ss75710541/marathon,matsluni/marathon,janisz/marathon,Yhgenomics/marathon,Caerostris/marathon,mesosphere/marathon,janisz/marathon,timcharper/marathon,gsantovena/marathon,Yhgenomics/marathon,bsideup/marathon,sepiroth887/marathon,janisz/marathon,murat-lacework/marathon,sepiroth887/marathon,mikejihbe/marathon,MrMarvin/marathon,meln1k/marathon,manojlds/marathon,matsluni/marathon,Caerostris/marathon,manojlds/marathon,sepiroth887/marathon