title: generate godoc documentation for an entire project?
body: <p>I've been wrestling with godoc and found that "go doc" is more for providing  usage help from the command line for instance:</p>
  
  <pre><code>go doc -cmd -u
  </code></pre>
  
  <p>lists the package comment and any functions (or other entities)</p>
  
  <pre><code>go doc *function*
  </code></pre>
  
  <p>then shows the documentation for an individual function (or other entity)</p>
  
  <p>It seems there is a related tool called <em>godoc</em>. 
  godoc also seems to generate html on a per package and function basis.
  E.g.</p>
  
  <pre><code>godoc -html hello
  </code></pre>
  
  <p>Generates html containing the package comment only to stdout</p>
  
  <p><em>godoc</em> is a really confusing name given we have <em>go doc</em> as well!</p>
  
  <p><strong>How can I create static documentation for the whole project?</strong></p>
  
  <p>This is similar to <a href="https://stackoverflow.com/questions/38331224/godoc-create-html-for-entire-package">Godoc, create html for entire package</a> which may have been misinterpreted as asking about documentation for packages rather than projects.
  I want a build step I can use in a project that may in principle contain many packages and apps.</p>