As I mentioned in FLINK-31177 (
https://issues.apache.org/jira/browse/FLINK-31177):

Currently, markdown files in *docs* are maintained and updated by many
contributors, and different people have varying code style taste. By the
way, as the syntax of markdown is not really strict, the styles tend to be
inconsistent.

To name a few,

   - Some prefer `*` to make a list item, while others may prefer `-`.
   - It is common to  leave many unnecessary blank lines and spaces.
   - To make a divider, the number of `-` can be varying.

To this end, I think it would be nicer to encourage or demand contributors
to format their markdown files before making a pull request.  Personally, I
think Prettier (https://prettier.io/) is a good candidate.
What do you think?

-- 
Zhongpu Chen

Reply via email to