docs: document known rough edges (#609)

Start keeping a log of rough edges we've discovered post v1.0.0, so that
they're discoverable (along with their workarounds), and so that we can
fix them in v2.

internal/docs/doc.go

@@ -8,6 +8,7 @@
 //go:generate weave -o ../../docs/client.md ./client.src.md
 //go:generate weave -o ../../docs/server.md ./server.src.md
 //go:generate weave -o ../../docs/troubleshooting.md ./troubleshooting.src.md
+//go:generate weave -o ../../docs/rough_edges.md ./rough_edges.src.md
 
 // The doc package generates the documentation at /doc, via go:generate.
 //