Ver Fonte

Decision for Comments #198 (#275)

Jon Meow há 5 anos atrás
pai
commit
41786eae25
2 ficheiros alterados com 38 adições e 0 exclusões
  1. 1 0
      proposals/README.md
  2. 37 0
      proposals/p0198_decision.md

+ 1 - 0
proposals/README.md

@@ -60,6 +60,7 @@ request:
 -   [0196 - Language-level safety strategy](p0196.md)
     -   [0196 - Decision](p0196_decision.md)
 -   [0198 - Comments](p0198.md)
+    -   [0198 - Decision](p0198_decision.md)
 -   [0199 - String literals](p0199.md)
     -   [0199 - Decision](p0199_decision.md)
 -   [0253 - 2021 Roadmap](p0253.md)

+ 37 - 0
proposals/p0198_decision.md

@@ -0,0 +1,37 @@
+# Decision for: Comments
+
+<!--
+Part of the Carbon Language project, under the Apache License v2.0 with LLVM
+Exceptions. See /LICENSE for license information.
+SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+-->
+
+Proposal accepted on 2021-02-19
+
+Affirming:
+
+-   [austern](https://github.com/austern)
+-   [chandlerc](https://github.com/chandlerc)
+-   [geoffromer](https://github.com/geoffromer)
+-   [gribozavr](https://github.com/gribozavr)
+-   [josh11b](https://github.com/josh11b)
+-   [zygoloid](https://github.com/zygoloid)
+
+Abstaining:
+
+-   [noncombatant](https://github.com/noncombatant)
+-   [tituswinters](https://github.com/tituswinters)
+
+## Rationale
+
+-   Some comment syntax is necessary to support software evolution, readable and
+    understandable code, and many other goals of Carbon.
+-   A single, simple, and consistent comment style supports Carbon's goal of
+    easy to read and understand code, and fast development tools.
+-   The experiment of restricting comments to be the only non-whitespace text on
+    a line supports Carbon's goal of software evolution.
+-   The careful open lexical space left supports Carbon's goal of language
+    evolution.
+-   The use of `//` as the primary syntax marking comments supports
+    interoperability with C++-trained programmers and codebases by avoiding
+    unnecessary and unhelpful churn of comment syntax.