[jira] [Commented] (BEAM-11528) Document of runners needs conversion to Hugo

["Beam JIRA Bot (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/BEAM-11528?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17291785#comment-17291785 ] 

Beam JIRA Bot commented on BEAM-11528:
--------------------------------------

This issue is P2 but has been unassigned without any comment for 60 days so it has been labeled "stale-P2". If this issue is still affecting you, we care! Please comment and remove the label. Otherwise, in 14 days the issue will be moved to P3.

Please see https://beam.apache.org/contribute/jira-priorities/ for a detailed explanation of what these priorities mean.


> Document of runners needs conversion to Hugo
> --------------------------------------------
>
>                 Key: BEAM-11528
>                 URL: https://issues.apache.org/jira/browse/BEAM-11528
>             Project: Beam
>          Issue Type: Bug
>          Components: examples-python
>    Affects Versions: 2.26.0
>            Reporter: Martin Blais
>            Priority: P2
>              Labels: stale-P2
>
> The documentation on runners shows some unrendered language specific markup here:
> [https://beam.apache.org/documentation/runners/direct/]
> One see \{:.language-py}.
> These look like forgotten markup from another template system. I had a quick go at attempting to modify those but it's not obvious how to do it properly.
>  
> These threw me off while reading the documentation.
> Furthermore, it would be really useful to document the distinction between the DirectRunner and FnApiRunner, which is only available by browsing the source code. The distinction in the documentation isn't made clearly and it's confusing.
>  



--
This message was sent by Atlassian Jira
(v8.3.4#803005)