Function normalizeDocURL

tools/metadata/metadata.go:488–510

normalizeDocURL cleans docURL's path and enforces metadataDocsAPIVersion for https://docs.github.com/rest and https://docs.github.com/enterprise-cloud@latest/rest URLs.

(docURL string)

// https://docs.github.com/rest and
// https://docs.github.com/enterprise-cloud@latest/rest URLs.
func normalizeDocURL(docURL string) string {
	u, err := url.Parse(docURL)
	if err != nil {
		return docURL
	}
	cleanPath := path.Clean(u.Path)
	isRESTDocsURL := u.Host == "docs.github.com" &&
		(cleanPath == "/rest" ||
			strings.HasPrefix(cleanPath, "/rest/") ||
			cleanPath == "/enterprise-cloud@latest/rest" ||
			strings.HasPrefix(cleanPath, "/enterprise-cloud@latest/rest/"))
	if !isRESTDocsURL {
		return docURL
	}

	u.Path = cleanPath
	q := u.Query()
	if q.Get("apiVersion") == "" {
		q.Set("apiVersion", metadataDocsAPIVersion)
	}
	u.RawQuery = q.Encode()
	return u.String()
}

// nodeServiceMethod returns the name of the service method represented by fn, or "" if fn is not a service method.
// Name is in the form of "Receiver.Function", for example "IssuesService.Create".