You are viewing a plain text version of this content. The canonical link for it is here.

Posted to commits@beam.apache.org by "Tibor Kiss (JIRA)" <ji...@apache.org> on 2017/03/20 08:41:41 UTC

[jira] [Created] (BEAM-1756) Annotate code references inside inline documentation in Python-SDK

Tibor Kiss created BEAM-1756:
--------------------------------

             Summary: Annotate code references inside inline documentation in Python-SDK
                 Key: BEAM-1756
                 URL: https://issues.apache.org/jira/browse/BEAM-1756
             Project: Beam
          Issue Type: Bug
          Components: sdk-py
            Reporter: Tibor Kiss
            Priority: Minor


Some of the inline documentation in Python-SDK contains references to classes, methods or fields. The document generation tool (Sphinx) supports annotating such code blocks. 

If the inline documentation is annotated properly then the references will be linked (clickable) on the generated site.

Relevant Sphinx documentation:
http://www.sphinx-doc.org/en/stable/markup/inline.html#xref-syntax




--
This message was sent by Atlassian JIRA
(v6.3.15#6346)