pre-commit: add markdownlint and fix Markdown linter errors (#40)

Add basic config file to start

Author: jbampton

.github/linters/.markdown-lint.yml

@@ -0,0 +1,26 @@
+# MD013/line-length Line length
+MD013: false
+
+# MD007/ul-indent Unordered list indentation
+MD007: false
+
+# MD025/single-title/single-h1 Multiple top-level headings in the same document
+MD025: false
+
+# MD028/no-blanks-blockquote Blank line inside blockquote
+MD028: false
+
+# MD029/ol-prefix Ordered list item prefix
+MD029: false
+
+# MD034/no-bare-urls Bare URL used
+MD034: false
+
+# MD041/first-line-heading/first-line-h1 First line in a file should be a top-level heading
+MD041: false
+
+# MD055/table-pipe-style Table pipe style
+MD055: false
+
+# MD056/table-column-count Table column count
+MD056: false

.pre-commit-config.yaml

@@ -35,6 +35,15 @@ repos:
       - id: trailing-whitespace
         args: [--markdown-linebreak-ext=md]
         exclude: \.svg$
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.45.0
+    hooks:
+      - id: markdownlint
+        name: run markdownlint
+        description: check Markdown files with markdownlint
+        args: [--config=.github/linters/.markdown-lint.yml]
+        types: [markdown]
+        files: \.md$
   - repo: https://github.com/adrienverge/yamllint
     rev: v1.37.1
     hooks:

content/pages/agenda-tool.md

@@ -6,4 +6,5 @@ license: https://www.apache.org/licenses/LICENSE-2.0
 The secondary project is the Board Agenda Tool.
 
 Repository
+
 - https://github.com/apache/tooling-agenda

content/pages/data-model.md

@@ -1,7 +1,6 @@
 Title: Apache Trusted Release Data Model
 license: https://www.apache.org/licenses/LICENSE-2.0
 
-
 _This is a discussion and the actual implementation will diverge._
 
 Here is an introduction to the ATR's data model.

content/pages/platform.md

@@ -1,7 +1,6 @@
 Title: Apache Trusted Release Platform Services
 license: https://www.apache.org/licenses/LICENSE-2.0
 
-
 _This is a discussion and the actual implementation will diverge._
 
 https://releases.apache.org

content/pages/team.md

@@ -2,10 +2,13 @@ Title: About the Apache Tooling Team
 license: https://www.apache.org/licenses/LICENSE-2.0
 
 # ASF Tooling
+
 The ASF Tooling team, known as **Tooling**, provides tooling development for select ASF Initiatives.
 
 ## About us
+
 Tooling has a core team made up of a number of paid contractors, whom are senior software engineers; and volunteers. The core team collaborates to develop specific software, work with and contribute to Infra. The volunteers bring their skills to bear on their areas of interest, reducing the load on the core team.
 
 ## How you can help
+
 Volunteers are the driving force of the ASF. The Tooling team is looking for people willing to help out at whatever effort level suits. If you're interested, visit our [volunteer information](volunteer.html) page.

content/pages/trusted-release.md

@@ -4,6 +4,7 @@ license: https://www.apache.org/licenses/LICENSE-2.0
 The main project is the Apache Trusted Release Platform.
 
 Repositories:
+
 - https://github.com/apache/tooling-trusted-release
 - https://github.com/apache/tooling-releases-client
 

content/pages/volunteer.md

@@ -1,7 +1,6 @@
 Title: Volunteering for ASF Tooling
 license: https://www.apache.org/licenses/LICENSE-2.0
 
-
 There are opportunities to volunteer to help develop new tooling for the ASF.
 
 There are some basic things you could do if you're going to help out with the ASF Tooling team.