Code change:
Right now, we have a mixture of user documentation and developer documentation in the top-level directory. We should make it easier to find a just user documentation. Step 1 would be to move developer documentation into a subdir like docs/development or something like that. User docs would stay in the top-level docs dir.
move to

Related discussion:
text: <ins> <?xml version="1.0" encoding="UTF-8" standalone="no"?> <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"> <!-- Generated by graphviz version 2.36.0 (20140111.2315) --> <!-- Title: tagged_release Pages: 1 --> <svg width="257pt" height="360pt" viewBox="0.00 0.00 257.33 360.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"> <g id="graph0" class="graph" transform="scale(0.649819 0.649819) rotate(0) translate(4 550)"> <title>tagged_release</title> <polygon fill="white" stroke="none" points="-4,4 -4,-550 392,-550 392,4 -4,4"/> <!-- ci012abc --> <g id="node1" class="node"><title>ci012abc</title> <ellipse fill="#ffffcc" stroke="black" cx="56" cy="-115" rx="42.7926" ry="42.7926"/> <text text-anchor="middle" x="56" y="-111.3" font-family="Consolas, Liberation Mono, Menlo, Courier, monospace" font-size="14.00">012abc</text> </g> <!-- pr101 --> <g id="node2" class="node"><title>pr101</title> <polygon fill="#ccccff" stroke="black" points="112,-255 0,-255 0,-219 112,-219 112,-255"/> <text text-anchor="middle" x="56" y="-233.3" font-family="Helvetica Neue, Helvetica, Segoe UI, Arial, freesans, sans-serif" font-size="14.00">Merge PR #101</text> </g> <!-- ci012abc&#45;&gt;pr101 --> <g id="edge1" class="edge"><title>ci012abc&#45;&gt;pr101</title> <path fill="none" stroke="black" d="M56,-157.97C56,-174.83 56,-193.784 56,-208.789"/> <polygon fill="black" stroke="black" points="52.5001,-208.93 56,-218.93 59.5001,-208.93 52.5001,-208.93"/> </g> <!-- ci345cde --> <g id="node3" class="node"><title>ci345cde</title> <ellipse fill="#ffffcc" stroke="black" cx="62" cy="-359" rx="42.7926" ry="42.7926"/> <text text-anchor="middle" x="62" y="-355.3" font-family="Consolas, Liberation Mono, Menlo, Courier, monospace" font-size="14.00">345cde</text> </g> <!-- pr101&#45;&gt;ci345cde --> <g id="edge2" class="edge"><title>pr101&#45;&gt;ci345cde</title> <path fill="none" stroke="black" d="M56.8597,-255.193C57.5237,-268.473 58.4796,-287.592 59.3874,-305.748"/> <polygon fill="black" stroke="black" points="55.904,-306.17 59.8991,-315.982 62.8953,-305.82 55.904,-306.17"/> </g> <!-- pr102 --> <g id="node4" class="node"><title>pr102</title> <polygon fill="#ccccff" stroke="black" points="129,-474 17,-474 17,-438 129,-438 129,-474"/> <text text-anchor="middle" x="73" y="-452.3" font-family="Helvetica Neue, Helvetica, Segoe UI, Arial, freesans, sans-serif" font-size="14.00">Merge PR #102</text> </g> <!-- ci345cde&#45;&gt;pr102 --> <g id="edge3" class="edge"><title>ci345cde&#45;&gt;pr102</title> <path fill="none" stroke="black" d="M66.8248,-401.668C67.8523,-410.542 68.9117,-419.692 69.8567,-427.853"/> <polygon fill="black" stroke="black" points="66.3936,-428.375 71.0207,-437.906 73.3472,-427.57 66.3936,-428.375"/> </g> <!-- pr100 --> <g id="node10" class="node"><title>pr100</title> <polygon fill="#ccccff" stroke="black" points="174,-546 62,-546 62,-510 174,-510 174,-546"/> <text text-anchor="middle" x="118" y="-524.3" font-family="Helvetica Neue, Helvetica, Segoe UI, Arial, freesans, sans-serif" font-size="14.00">Merge PR #100</text> </g> <!-- pr102&#45;&gt;pr100 --> <g id="edge6" class="edge"><title>pr102&#45;&gt;pr100</title> <path fill="none" stroke="black" d="M84.1236,-474.303C89.355,-482.441 95.6999,-492.311 101.478,-501.299"/> <polygon fill="black" stroke="black" points="98.6526,-503.377 107.004,-509.896 104.541,-499.591 98.6526,-503.377"/> </g> <!-- version_commit --> <g id="node5" class="node"><title>version_commit</title> <ellipse fill="#ccffcc" stroke="black" cx="173" cy="-237" rx="42.7926" ry="42.7926"/> <text text-anchor="middle" x="173" y="-233.3" font-family="Consolas, Liberation Mono, Menlo, Courier, monospace" font-size="14.00">678fed</text> </g> <!-- dev_commit --> <g id="node6" class="node"><title>dev_commit</title> <ellipse fill="#ffffcc" stroke="black" cx="169" cy="-359" rx="42.7926" ry="42.7926"/> <text text-anchor="middle" x="169" y="-355.3" font-family="Consolas, Liberation Mono, Menlo, Courier, monospace" font-size="14.00">456dcb</text> </g> <!-- version_commit&#45;&gt;dev_commit --> <g id="edge4" class="edge"><title>version_commit&#45;&gt;dev_commit</title> <path fill="none" stroke="black" d="M171.601,-279.97C171.322,-288.326 171.027,-297.195 170.739,-305.844"/> <polygon fill="black" stroke="black" points="167.24,-305.74 170.405,-315.851 174.236,-305.973 167.24,-305.74"/> </g> <!-- dev_commit&#45;&gt;pr100 --> <g id="edge8" class="edge"><title>dev_commit&#45;&gt;pr100</title> <path fill="none" stroke="black" d="M158.36,-400.568C152.438,-422.433 144.719,-449.815 137,-474 134.253,-482.606 131.013,-491.906 127.994,-500.278"/> <polygon fill="black" stroke="black" points="124.616,-499.325 124.47,-509.919 131.191,-501.729 124.616,-499.325"/> </g> <!-- release_info --> <g id="node7" class="node"><title>release_info</title> <text text-anchor="middle" x="304" y="-240.8" font-family="Helvetica Neue, Helvetica, Segoe UI, Arial, freesans, sans-serif" font-size="14.00">pkg/version/base.go:</text> <text text-anchor="middle" x="304" y="-225.8" font-family="Helvetica Neue, Helvetica, Segoe UI, Arial, freesans, sans-serif" font-size="14.00">gitVersion = &quot;v0.5&quot;;</text> </g> <!-- dev_info --> <g id="node8" class="node"><title>dev_info</title> <text text-anchor="middle" x="309" y="-362.8" font-family="Helvetica Neue, Helvetica, Segoe UI, Arial, freesans, sans-serif" font-size="14.00">pkg/version/base.go:</text> <text text-anchor="middle" x="309" y="-347.8" font-family="Helvetica Neue, Helvetica, Segoe UI, Arial, freesans, sans-serif" font-size="14.00">gitVersion = &quot;v0.5&#45;dev&quot;;</text> </g> <!-- pr99 --> <g id="node9" class="node"><title>pr99</title> <polygon fill="#ccccff" stroke="black" points="143,-36 39,-36 39,-0 143,-0 143,-36"/> <text text-anchor="middle" x="91" y="-14.3" font-family="Helvetica Neue, Helvetica, Segoe UI, Arial, freesans, sans-serif" font-size="14.00">Merge PR #99</text> </g> <!-- pr99&#45;&gt;ci012abc --> <g id="edge5" class="edge"><title>pr99&#45;&gt;ci012abc</title> <path fill="none" stroke="black" d="M84.5805,-36.4245C81.5586,-44.6267 77.7879,-54.8615 73.9865,-65.1795"/> <polygon fill="black" stroke="black" points="70.6804,-64.0292 70.5075,-74.6226 77.2488,-66.4492 70.6804,-64.0292"/> </g> <!-- pr99&#45;&gt;version_commit --> <g id="edge7" class="edge"><title>pr99&#45;&gt;version_commit</title> <path fill="none" stroke="black" d="M97.4344,-36.0276C109.585,-68.1826 136.317,-138.924 154.498,-187.038"/> <polygon fill="black" stroke="black" points="151.318,-188.523 158.127,-196.64 157.866,-186.048 151.318,-188.523"/> </g> <!-- tag --> <g id="node11" class="node"><title>tag</title> <ellipse fill="#ffcccc" stroke="black" cx="226" cy="-115" rx="71.4873" ry="18"/> <text text-anchor="middle" x="226" y="-111.3" font-family="Helvetica Neue, Helvetica, Segoe UI, Arial, freesans, sans-serif" font-size="14.00">$ git tag &#45;a v0.5</text> </g> <!-- tag&#45;&gt;version_commit --> <g id="edge9" class="edge"><title>tag&#45;&gt;version_commit</title> <path fill="none" stroke="black" d="M218.519,-132.939C212.168,-147.318 202.736,-168.673 194.103,-188.22"/> <polygon fill="black" stroke="black" points="190.784,-187.071 189.946,-197.632 197.188,-189.899 190.784,-187.071"/> </g> </g> </svg> </ins>