add code hierarchy, ambari-shell info to docs

Also updates several sections with more accurate
information.