mirror of https://github.com/carbon-language/carbon-lang.git synced 2026-09-24 22:02:23 +01:00

Files

T

josh11bandRichard Smith 88e87b86b9 Updates to generics design details, part 2 (#3253 )

Continued from part 1: #3231. Second step updating
`docs/design/generics/details.md`. There remains some work to
incorporate proposal #2200.

- The biggest changes are incorporating much of the text of proposals:
  - #2173
  - #2687
- It incorporates changes from proposals:
  - #989
  - #1178
  - #2138
  - #2200
  - #2360
  - #2964
  - #3162
- It also updates the text to reflect the latest thinking from leads
issues:
  - #996
  - #2153 -- most notably deleting the section on `TypeId`.
- Update to rule for prioritization blocks with mixed type structures
from [discussion on
2023-07-18](https://docs.google.com/document/d/1gnJBTfY81fZYvI_QXjwKk1uQHYBNHGqRLI2BS_cYYNQ/edit?resourcekey=0-ql1Q1WvTcDvhycf8LbA9DQ#heading=h.7jxges9ojgy3)
- Adds reference links to proposals, issues, and discussions relevant to
the text.
- Also tries to use more precise language when talking about
implementations, to avoid confusing `impl` declaration and definitions
with the `impls` operator used in `where` clauses, an issue brought up
in
  - #2495 
  - #2483

---------

Co-authored-by: Richard Smith <richard@metafoo.co.uk>

2023-10-03 00:03:07 +00:00

design

Updates to generics design details, part 2 (#3253 )

2023-10-03 00:03:07 +00:00

guides

Update docs/ READMEs (#1211 )

2022-04-27 12:07:53 -07:00

images

Updating links for shared drive and access notes (#1933 )

2022-08-08 09:11:00 -07:00

project

Updates to design docs to reflect accepted proposals (#3254 )

2023-09-23 15:53:07 +00:00

spec

Initial rough framework for specification. (#140 )

2022-03-16 15:43:09 -07:00

README.md

Fix grammar errors (#1648 )

2022-07-24 12:37:00 -07:00

README.md

Docs

This directory contains current, accepted documentation underpinning Carbon. These documents cover all aspects of Carbon ranging from the project down to detailed designs for specific language features.

If you're trying to learn more about Carbon, we recommend starting at /README.md.

Design

Carbon language's design and rationale are documented in the design/ directory. This documentation is intended to support the following audiences:

People who wish to determine whether Carbon would be the right choice for a project compared to other existing languages.
People working on the evolution of the Carbon language who wish to understand the rationale and motivation for existing design decisions.
People working on a specification or implementation of the Carbon language who need a detailed understanding of the intended design.
People writing Carbon code who wish to understand why the language rules are the way they are.

This is in contrast to proposals, which document the individual decisions that led to this design (along with other changes to the Carbon project), including the rationale and alternatives considered.

Project

The project/ directory contains project-related documentation for Carbon, including:

goals, and the principles and roadmap derived from those goals,
how the project works, and
how to contribute.

Guides

The guides/ directory contains to-be-written end-user documentation for developers writing programs in Carbon.

Spec

The spec/ directory contains the to-be-written formal specification of the Carbon language. This is for implementers of compilers or other tooling. This is intended to complement the interactive language explorer tool.