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:44:41 UTC

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

     [ https://issues.apache.org/jira/browse/BEAM-1756?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Tibor Kiss updated BEAM-1756:
-----------------------------
    Issue Type: Improvement  (was: Bug)

> 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: Improvement
>          Components: sdk-py
>            Reporter: Tibor Kiss
>            Priority: Minor
>              Labels: newbie, starter
>
> 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)