uranusjr commented on pull request #19124: URL: https://github.com/apache/airflow/pull/19124#issuecomment-951552240
I think it's kind of a tradeoff. Markdown is intuitive, but that brings in the cost of syntax ambiguity (Markdown is far more difficult to parse than restructuredText) and lack of extendability (because all the intuitive constructs are already used up). Markdown is good for short, one-off documents, but restructuredText is striking a good balance for long-form technical documentation. -- 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. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
