|
|
@@ -125,7 +125,7 @@ in addition to the `code_and_organization.md` alternatives section.
|
|
|
Right now, the `package` syntax is very package-oriented. We could instead
|
|
|
eliminate package semantics from code and organization, relying only on
|
|
|
libraries and removing the link to distribution. This is the
|
|
|
-[collapse the package concept into libraries](/docs/design/code_and_name_organization.md#collapse-the-package-concept-into-libraries)
|
|
|
+[collapse the package concept into libraries](#collapse-the-package-concept-into-libraries)
|
|
|
alternative.
|
|
|
|
|
|
Does the core team agree with the approach to packages and libraries? If not,
|
|
|
@@ -141,7 +141,7 @@ Right now, the `package` syntax requires the package's own name be repeated
|
|
|
through code. This touches on a couple alternatives:
|
|
|
|
|
|
- Strict association between the file system path and library/namespace
|
|
|
-- [Referring to the package as `package`](/docs/design/code_and_name_organization.md#referring-to-the-package-as-package)
|
|
|
+- [Referring to the package as `package`](#referring-to-the-package-as-package)
|
|
|
|
|
|
The end result of taking both alternatives would be that:
|
|
|
|
|
|
@@ -179,7 +179,7 @@ The end result of taking both alternatives would be that:
|
|
|
IDE tab completion to more easily determine which APIs can be used from
|
|
|
a given library.
|
|
|
|
|
|
-- [Fast and scalable development](/docs/projects/goals.md#fast-and-scalable-development):
|
|
|
+- [Fast and scalable development](/docs/project/goals.md#fast-and-scalable-development):
|
|
|
|
|
|
- The structure of libraries and imports should help enable separate
|
|
|
compilation, particularly improving performance for large codebases.
|
|
|
@@ -1341,7 +1341,7 @@ Disadvantages:
|
|
|
- Carbon may disallow the same-line-as-code comment style used for this.
|
|
|
Even if not, if we acknowledge it's a problem, we should address it
|
|
|
structurally for
|
|
|
- [readability](/docs/projects/goals.md#code-that-is-easy-to-read-understand-and-write).
|
|
|
+ [readability](/docs/project/goals.md#code-that-is-easy-to-read-understand-and-write).
|
|
|
- This is less of a problem for other scopes, such as functions, because
|
|
|
they can often be broken apart until they fit on a single screen.
|
|
|
|