gapic-generator-python icon indicating copy to clipboard operation
gapic-generator-python copied to clipboard

Published 20 hours ago • verified publisher icon googleapis

generator should transform brackets to reference links

Open dizcology opened this issue 4 years ago • 1 comments

example: https://googleapis.dev/python/documentai/latest/documentai_v1beta2/types.html#google.cloud.documentai_v1beta2.types.Document.PageAnchor.PageRef.layout_id

where we have

Optional. The [Page.Layout.id][google.cloud.documentai.v1beta2.Document.Page.Layout.id] on the page that this element references. If [LayoutRef.type][] is specified this id must also be specified.

The brackets should have been transformed into rst links so that sphinx can properly generate cross reference links, e.g. https://www.sphinx-doc.org/en/1.7/markup/inline.html#cross-referencing-syntax

dizcology avatar Jun 23 '20 17:06 dizcology

@JustinBeckwith Is there a main bug where we're tracking the FR for protobuf comment parsing ?

busunkim96 avatar Oct 14 '20 22:10 busunkim96