Docs for route conflicts?

[pesterhazy]

Is the following behavior documented? I couldn't find it (searching for "conflict" and "precedence").

When I create two routes with the same method and path, which one will match?

1. the first
2. the second
3. panic

It would be helpful to have clear docs for this case. net/http has a section on this topic: https://pkg.go.dev/net/http#hdr-Precedence

[pesterhazy]

Made an experiment to determine the rules

package app_test

import (
	"net/http"
	"net/http/httptest"
	"testing"

	"github.com/go-chi/chi/v5"
	"gotest.tools/assert"
)

func TestTheLastRouteTakesPrecedence(t *testing.T) {
	var ans string

	chi := chi.NewRouter()
	chi.Get("/foo", func(w http.ResponseWriter, r *http.Request) {
		ans = "a"
	})
	chi.Get("/foo", func(w http.ResponseWriter, r *http.Request) {
		ans = "b"
	})
	chi.Get("/foo", func(w http.ResponseWriter, r *http.Request) {
		ans = "c"
	})
	chi.ServeHTTP(httptest.NewRecorder(), httptest.NewRequest("GET", "/foo", nil))
	assert.Equal(t, "c", ans)
}

func TestSpecificStringTakesPrecedenceOverWildcard(t *testing.T) {
	var ans string

	chi := chi.NewRouter()
	chi.Get("/foo", func(w http.ResponseWriter, r *http.Request) {
		ans = "a"
	})
	chi.Get("/*", func(w http.ResponseWriter, r *http.Request) {
		ans = "b"
	})
	chi.ServeHTTP(httptest.NewRecorder(), httptest.NewRequest("GET", "/foo", nil))
	assert.Equal(t, "a", ans)
}

func TestSpecificRouteWinsWithWildcardSuffix(t *testing.T) {
	var ans string

	chi := chi.NewRouter()
	chi.Get("/foo", func(w http.ResponseWriter, r *http.Request) {
		ans = "a"
	})
	chi.Get("/foo*", func(w http.ResponseWriter, r *http.Request) {
		ans = "b"
	})
	chi.ServeHTTP(httptest.NewRecorder(), httptest.NewRequest("GET", "/foo", nil))
	assert.Equal(t, "a", ans)
}

func TestSuffixWildcardMatches(t *testing.T) {
	var ans string

	chi := chi.NewRouter()
	chi.Get("/foo*", func(w http.ResponseWriter, r *http.Request) {
		ans = "a"
	})
	chi.ServeHTTP(httptest.NewRecorder(), httptest.NewRequest("GET", "/foo", nil))
	assert.Equal(t, "a", ans)
}