zitadel/proto/zitadel/docs/zitadel-md.tmpl
Fabi 2e3b0c54c0
docs: fix proto option generation (#1972)
* docs: fix proto option generation

* update

Co-authored-by: Livio Amstutz <livio.a@gmail.com>
2021-07-05 14:16:39 +00:00

60 lines
1.6 KiB
Cheetah

{{range .Files}}---
title: {{.Name}}
---
> This document reflects the state from API 1.0 (available from 20.04.2021)
{{if .HasServices}}
{{range .Services -}}
## {{.Name}} {#{{.FullName | lower | replace "." ""}}}
{{.Description}}
{{range .Methods -}}
### {{.Name}}
> **rpc** {{.Name}}([{{.RequestLongType}}](#{{.RequestLongType | lower | replace "." ""}}))
[{{.ResponseLongType}}](#{{.ResponseLongType | lower | replace "." ""}})
{{ .Description}}
{{$httpOption := .Option "google.api.http"}}
{{range $httpOption.Rules}}
{{ .Method }}: {{ .Pattern }}
{{end}}
{{end}}
{{end}}
{{end}}
{{if .HasMessages}}
## Messages
{{range .Messages}}
### {{.LongName}}
{{.Description}}
{{if .HasFields}}
| Field | Type | Description | Validation |
| ----- | ---- | ----------- | ----------- |
{{range .Fields -}}
| {{if .IsOneof}}[**oneof**](https://developers.google.com/protocol-buffers/docs/proto3#oneof) {{.OneofDecl}}.{{end}}{{.Name}} | {{if .IsMap}}map {{else}}{{.Label}} {{end}}{{.LongType}} | {{if .Description}}{{nobr .Description}}{{if .DefaultValue}} Default: {{.DefaultValue}}{{end}}{{else}}-{{end}} | {{$validateOption := .Option "validate.rules"}}{{range $validateOption.Rules}}{{ .Name }}: {{ .Value }}<br /> {{end}} |
{{end}}
{{end}}
{{end}}
{{end}}
{{if .HasEnums }}
## Enums
{{range .Enums}}
### {{.LongName}} {#{{.LongName | lower | replace "." ""}}}
{{.Description}}
| Name | Number | Description |
| ---- | ------ | ----------- |
{{range .Values -}}
| {{.Name}} | {{.Number}} | {{if .Description}}{{nobr .Description}}{{else}}-{{end}} |
{{end}}
{{end}}
{{end}}
{{end}}