aaltay commented on pull request #11796: URL: https://github.com/apache/beam/pull/11796#issuecomment-635462639
> @pabloem What is the point of having the code_sample directive in the first place? Wouldn't it be clearer and easier to edit documentation if all code samples are inline in the markdown itself? We can run unit tests against snippets coming from source code files. That prevent snippets from having issues or getting out of sync with rest of the code. It is not straightforward to do the same thing with inlined code samples. ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org