carbon-language · jonmeow · Nov 14, 2020 · Nov 13, 2020 · Nov 13, 2020 · Nov 14, 2020
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -24,7 +24,7 @@ repos:
         args: ['--fix=lf']
       - id: trailing-whitespace
   - repo: https://github.com/google/pre-commit-tool-hooks
-    rev: v1.0.4
+    rev: v1.1.0
     hooks:
       - id: check-copyright
         args:
@@ -34,6 +34,8 @@ repos:
             Exceptions. See /LICENSE for license information.
             SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
         exclude: '^src/jekyll/(Gemfile.lock|theme/.*)$'
+      - id: check-google-doc-style
+      - id: markdown-toc
   - repo: https://github.com/codespell-project/codespell
     rev: v1.17.1
     hooks:
@@ -42,14 +44,6 @@ repos:
         exclude: '^src/jekyll/Gemfile.lock$'
   - repo: local
     hooks:
-      - id: markdown-toc
-        name: Update table of contents
-        description: Runs https://github.com/jonschlinkert/markdown-toc
-        entry: src/scripts/pre_commit_toc.js
-        language: node
-        additional_dependencies: [markdown-toc]
-        files: .*\.md$
-        exclude: ^src/jekyll/theme/
       - id: proposal-list
         name: Update list of proposals
         description: Updates the list of proposals in proposals/README.md
@@ -67,3 +61,8 @@ repos:
     hooks:
       - id: prettier
         exclude: ^src/jekyll/theme/
+  # Run linters last, as formatters and other checks may fix issues.
+  - repo: https://gitlab.com/PyCQA/flake8
+    rev: 3.8.4
+    hooks:
+      - id: flake8
diff --git a/docs/design/README.md b/docs/design/README.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [Context and disclaimer](#context-and-disclaimer)
     -   [Example code](#example-code)
 -   [Basic syntax](#basic-syntax)

diff --git a/docs/design/aliases.md b/docs/design/aliases.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
     -   [Alternatives](#alternatives)

diff --git a/docs/design/blocks_and_statements.md b/docs/design/blocks_and_statements.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
 

diff --git a/docs/design/code_and_name_organization/README.md b/docs/design/code_and_name_organization/README.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [Goals and philosophy](#goals-and-philosophy)
 -   [Overview](#overview)
     -   [Sizing packages and libraries](#sizing-packages-and-libraries)

diff --git a/docs/design/code_and_name_organization/source_files.md b/docs/design/code_and_name_organization/source_files.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [Overview](#overview)
 -   [Encoding](#encoding)
 -   [References](#references)

diff --git a/docs/design/control_flow.md b/docs/design/control_flow.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
 -   [Open questions](#open-questions)

diff --git a/docs/design/functions.md b/docs/design/functions.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Basic functions](#basic-functions)
 

diff --git a/docs/design/interoperability/README.md b/docs/design/interoperability/README.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
 

diff --git a/docs/design/lexical_conventions/README.md b/docs/design/lexical_conventions/README.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Lexical elements](#lexical-elements)
 

diff --git a/docs/design/lexical_conventions/numeric_literals.md b/docs/design/lexical_conventions/numeric_literals.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [Overview](#overview)
 -   [Details](#details)
     -   [Integer literals](#integer-literals)

diff --git a/docs/design/lexical_conventions/whitespace.md b/docs/design/lexical_conventions/whitespace.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [Overview](#overview)
 
 <!-- tocstop -->

diff --git a/docs/design/lexical_conventions/words.md b/docs/design/lexical_conventions/words.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [Overview](#overview)
 -   [Alternatives](#alternatives)
 

diff --git a/docs/design/metaprogramming.md b/docs/design/metaprogramming.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
 

diff --git a/docs/design/name_lookup.md b/docs/design/name_lookup.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
     -   [Unqualified name lookup](#unqualified-name-lookup)

diff --git a/docs/design/naming_conventions.md b/docs/design/naming_conventions.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
 

diff --git a/docs/design/operators.md b/docs/design/operators.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 
 <!-- tocstop -->

diff --git a/docs/design/pattern_matching.md b/docs/design/pattern_matching.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
     -   [Pattern match control flow](#pattern-match-control-flow)

diff --git a/docs/design/primitive_types.md b/docs/design/primitive_types.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
     -   [Integers](#integers)

diff --git a/docs/design/structs.md b/docs/design/structs.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
 -   [Open questions](#open-questions)

diff --git a/docs/design/syntactic_conventions.md b/docs/design/syntactic_conventions.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
 -   [Alternatives](#alternatives)

diff --git a/docs/design/templates.md b/docs/design/templates.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
     -   [Types with template parameters](#types-with-template-parameters)

diff --git a/docs/design/tuples.md b/docs/design/tuples.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
     -   [Indices as compile-time constants](#indices-as-compile-time-constants)

diff --git a/docs/design/variables.md b/docs/design/variables.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [TODO](#todo)
 -   [Overview](#overview)
     -   [Declaring constants](#declaring-constants)

diff --git a/docs/project/code_review.md b/docs/project/code_review.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [High level goals of code review](#high-level-goals-of-code-review)
 -   [What requires review?](#what-requires-review)
 -   [Who should review?](#who-should-review)

diff --git a/docs/project/contribution_tools.md b/docs/project/contribution_tools.md
@@ -9,10 +9,10 @@ SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 The Carbon language project has a number of tools used to assist in preparing
 contributions.
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [Main tools](#main-tools)
     -   [brew](#brew)
     -   [pyenv and Python](#pyenv-and-python)

diff --git a/docs/project/cpp_style_guide.md b/docs/project/cpp_style_guide.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [Background](#background)
 -   [Baseline](#baseline)
 -   [Carbon-local guidance](#carbon-local-guidance)

diff --git a/docs/project/goals.md b/docs/project/goals.md
@@ -6,10 +6,10 @@ Exceptions. See /LICENSE for license information.
 SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 -->
 
-## Table of contents
-
 <!-- toc -->
 
+## Table of contents
+
 -   [Overview](#overview)
 -   [Project goals](#project-goals)
     -   [Community and culture](#community-and-culture)