[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=17300447#comment-17300447 ] 

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

This issue was marked "stale-P2" and has not received a public comment in 14 days. It is now automatically moved to P3. If you are still affected by it, you can comment and move it back to P2.

> 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: P3
>
> 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)