فهرست منبع

rephrase a few sentences (#3766)

Minor tweaks while reading through the docs to hopefully improve
readability.
Nathan Youngman 2 سال پیش
والد
کامیت
10189bbb78
4فایلهای تغییر یافته به همراه15 افزوده شده و 16 حذف شده
  1. 5 5
      docs/design/README.md
  2. 2 3
      docs/project/principles/information_accumulation.md
  3. 3 3
      docs/project/principles/safety_strategy.md
  4. 5 5
      docs/project/roadmap.md

+ 5 - 5
docs/design/README.md

@@ -1304,9 +1304,9 @@ fn Positive(a: i64) -> auto {
 A _block_ is a sequence of _statements_. A block defines a
 A _block_ is a sequence of _statements_. A block defines a
 [scope](#declarations-definitions-and-scopes) and, like other scopes, is
 [scope](#declarations-definitions-and-scopes) and, like other scopes, is
 enclosed in curly braces (`{`...`}`). Each statement is terminated by a
 enclosed in curly braces (`{`...`}`). Each statement is terminated by a
-semicolon or block. [Expressions](#expressions), [assignments](assignment.md)
-and [`var`](#variable-var-declarations) and [`let`](#constant-let-declarations)
-are valid statements.
+semicolon or block. [Expressions](#expressions), [assignments](assignment.md),
+[`var`](#variable-var-declarations) and [`let`](#constant-let-declarations) are
+valid statements.
 
 
 Statements within a block are normally executed in the order they appear in the
 Statements within a block are normally executed in the order they appear in the
 source code, except when modified by control-flow statements.
 source code, except when modified by control-flow statements.
@@ -3731,8 +3731,8 @@ In conclusion, there are two patterns in how Carbon diverges from C++:
 
 
 -   Simplify and removing things to create space for new safety features. This
 -   Simplify and removing things to create space for new safety features. This
     trivially requires breaking backwards compatibility.
     trivially requires breaking backwards compatibility.
--   Re-engineer foundations to model and enforce safety. This has complex and
-    difficulty in C++ without first simplifying the language.
+-   Re-engineer foundations to model and enforce safety. This is complex and
+    difficult in C++ without first simplifying the language.
 
 
 This leads to Carbon's incremental path to safety:
 This leads to Carbon's incremental path to safety:
 
 

+ 2 - 3
docs/project/principles/information_accumulation.md

@@ -77,9 +77,8 @@ especially important to the coherence of generics and templates.
     attempt to observe a property of an incomplete class that is not known until
     attempt to observe a property of an incomplete class that is not known until
     the class is complete renders the program invalid.
     the class is complete renders the program invalid.
 -   When an `impl` needs to be resolved, only those `impl` declarations that
 -   When an `impl` needs to be resolved, only those `impl` declarations that
-    have that appear earlier are considered. However, if a later `impl`
-    declaration would change the result of any earlier `impl` lookup, the
-    program is invalid.
+    appear earlier are considered. However, if a later `impl` declaration would
+    change the result of any earlier `impl` lookup, the program is invalid.
 
 
 ## Exceptions
 ## Exceptions
 
 

+ 3 - 3
docs/project/principles/safety_strategy.md

@@ -694,8 +694,8 @@ Advantages:
 -   Probabilistic safety should come at lower performance cost (including CPU,
 -   Probabilistic safety should come at lower performance cost (including CPU,
     memory, and disk space).
     memory, and disk space).
     -   This will sometimes be significant, and as a result of multiple checks,
     -   This will sometimes be significant, and as a result of multiple checks,
-        could be the difference between the hardened build mode being 50% slower
-        than the performance build mode and being 200% slower.
+        could result in the hardened build mode being 50% slower than the
+        performance build mode instead of being 200% slower.
 
 
 Disadvantages:
 Disadvantages:
 
 
@@ -767,5 +767,5 @@ addition. If build modes are added for non-safety-related reasons, this may lead
 to moving build modes out of the safety strategy.
 to moving build modes out of the safety strategy.
 
 
 **Experiment**: This can be considered an experiment. Carbon may eventually add
 **Experiment**: This can be considered an experiment. Carbon may eventually add
-more than the initial three build modes, although the reticence to add more is
+more than the initial three build modes, although the reluctance to add more is
 likely to remain.
 likely to remain.

+ 5 - 5
docs/project/roadmap.md

@@ -52,8 +52,8 @@ This goal is not necessarily about complete support for the entire language
 design, but rather enough of it to support building the realistic and
 design, but rather enough of it to support building the realistic and
 interesting Carbon code that interoperates with C++.
 interesting Carbon code that interoperates with C++.
 
 
-Some example language features that we think are key to success here but far
-from an exhaustive list:
+Here are some example language features that we think are key to success, but
+this is far from an exhaustive list:
 
 
 -   Imports and a working [prelude] (the earliest stages of a standard library)
 -   Imports and a working [prelude] (the earliest stages of a standard library)
 -   Operator overloading and dispatch for expressions
 -   Operator overloading and dispatch for expressions
@@ -125,9 +125,9 @@ subsequent years.
 As we adjust our schedule and roadmap to reflect the realistic rate of progress,
 As we adjust our schedule and roadmap to reflect the realistic rate of progress,
 the _earliest_ it seems feasible to have everything we need to evaluate the 0.1
 the _earliest_ it seems feasible to have everything we need to evaluate the 0.1
 language is 2025. We're starting to be optimistic in 2024 that we'll be able to
 language is 2025. We're starting to be optimistic in 2024 that we'll be able to
-hit this in 2025, but ultimately this remains a lower bound. We may discover as
-we progress things that further push out the schedule here. That is the nature
-of an experimental project like Carbon.
+hit this in 2025, but ultimately this remains a lower bound. As we progress, we
+may discover things that push the schedule out further. That is the nature of an
+experimental project like Carbon.
 
 
 We expect that once we reach this milestone the community will be able to start
 We expect that once we reach this milestone the community will be able to start
 realistically evaluating Carbon as a C++ successor language. Of course, this
 realistically evaluating Carbon as a C++ successor language. Of course, this