[docs] Provide More Examples

[elithrar]

mux is powerful thanks to regex, but regex can be a wall to some users. We need to document these better.

e.g.

• r.HandleFunc("/foo{format:(.json)?}", Handler) allows you to handle optional extensions—a useful pattern. You could also do {format:(.json|.capnp|.raw)?} if you wanted as well.
• PathPrefix + static files (this comes up a lot)
• Naming routes.
• Unit testing handlers
• Writing per-route and whole-of-router middleware - func New() func(http.Handler) http.Handler vs func Thing(http.Handler) http.Handler vs func Thing(arg string, h http.Handler) http.Handler`

[elithrar]

Update:

• middleware was covered by the recent middleware feature.
• I covered how to test handlers a while ago on my blog: http://blog.questionable.services/article/testing-http-handlers-go/ (and need to port it here / use mux in the examples)

[elithrar]

Going to work on this over the coming weekend.

[stale]

This issue has been automatically marked as stale because it hasn't seen a recent update. It'll be automatically closed in a few days.