The "Use go templates" page is missing its actual go templates

[cpick]

📚 Documentation

usegotemplates.md contains examples that have go templates (ie things surrounded in double-curly-brackets), but the website's usegotemplates.html has those important sections stripped out.

Perhaps the pipeline that produces the website itself uses go templates and is trying to interpret them?

[johanbrandhorst]

Haha, that's a great bug. Yeah we obviously use a mustache templating engine somewhere. I wonder if we can escape these in the docs? It's possible the run the docs site locally via the script in the docs folder, so if someone would an easy way to experiment locally, you can run:

$ JEKYLL_GITHUB_TOKEN=<your-github-token> ./run.sh

From the ./docs directory.

[johanbrandhorst]

CC @Jeremytjuh

[iamrajiv]

@cpick @johanbrandhorst I think this happening because Jekyll uses liquid tags and double curlies are getting ripped out by the liquid processor. To overcome this issue we have to use {% raw %} tag something like this

## {% raw %}{{.RequestType.Name}}{% endraw %}

[johanbrandhorst]

This is fixed now: https://grpc-ecosystem.github.io/grpc-gateway/docs/mapping/customizingopenapioutput/#using-go-templates-in-protofile-comments 🎉