Hey Iceberg Nation, As I've gone through the Iceberg docs, I've noticed a
lot of inconsistencies with terminology, grammar, and style. As a
distributed community, we have a lot of non-native English speakers reading
and writing our documentation. I propose we adopt the Microsoft Style Guide
<https://learn.microsoft.com/en-us/style-guide/welcome/> to improve the
communication and consistency of the docs. Common rules like defaulting to
use present tense
<https://learn.microsoft.com/en-us/style-guide/grammar/verbs#verb-tense>
not only make the documentation consistent but also more accessible for
those who struggle to understand complex conjugations. Then there are
examples like making sure to capitalize proper nouns
<https://learn.microsoft.com/en-us/style-guide/grammar/nouns-pronouns#capitalization-and-proper-nouns>
like (Spark, Flink, Trino, Apache Software Foundation, etc...). You may
think, that's great Brian, but good luck getting everyone reading the
project and following that. I also want to propose adding a prose linter
called Vale <https://vale.sh/>, that will enable us to add the existing
rules for the Microsoft Style Guide
<https://lists.apache.org/thread/xo7r8b7fbxvbt5gplkfyb0nozlskxvyg>, and our
own custom rules to ensure consistent style with documentation changes.
Let's discuss this in the sync tomorrow! Bits
