瀏覽代碼

Add Abstract Section (#1895)

Reading through extensive problem and background documentation before seeing
what is being proposed is tedious for a reader. An abstract section at the
beginning of a document that provides a succinct summary helps a lot. We
propose adding such a section to our proposal template.
David Sankel 3 年之前
父節點
當前提交
ea0a37dbf3
共有 1 個文件被更改,包括 6 次插入0 次删除
  1. 6 0
      proposals/scripts/template.md

+ 6 - 0
proposals/scripts/template.md

@@ -13,6 +13,7 @@ SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 ## Table of contents
 
 -   [TODO: Initial proposal setup](#todo-initial-proposal-setup)
+-   [Abstract](#abstract)
 -   [Problem](#problem)
 -   [Background](#background)
 -   [Proposal](#proposal)
@@ -38,6 +39,11 @@ SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 TODOs indicate where content should be updated for a proposal. See
 [Carbon Governance and Evolution](/docs/project/evolution.md) for more details.
 
+## Abstract
+
+TODO: Describe, in a succinct paragraph, the gist of this document. This
+paragraph should be reproduced verbatim in the PR summary.
+
 ## Problem
 
 TODO: What problem are you trying to solve? How important is that problem? Who