mirror of
https://github.com/carbon-language/carbon-lang.git
synced 2026-09-24 13:50:10 +01:00
Chandler CarruthandRichard Smith
94d2c1c6d4
We've talked about adding the title to the filename several times over the years and it seems really valuable. This requires us to compute a "slug" for the title spelling that can be part of the filename. Beyond that, we crossed 7000 recently, and so it seems likely that we will need to add digits sooner rather than later here, so this goes ahead and moves us to 6 digits so we don't have to adjust again for a reasonable length of time. To implement this and ensure we can sustain it going forward this adds a tool to our pre-commit that validates (and corrects if needed) the filename. In order to update everything and keep links working, there are a _lot_ of changes, but the most interesting for direct review are in `proposals/scripts`. Assisted-by: Antigravity with Gemini --------- Co-authored-by: Richard Smith <richard@metafoo.co.uk>
1.5 KiB
1.5 KiB
Low context-sensitivity principle
Table of contents
Problem
Carbon needs a consistent policy on how willing we are to make syntax dependent on context.
Background
Rust has a statement of their ergonomic principles that talks about their approach to context dependence.
Proposal
We propose adding
(docs/project/principles/low_context_sensitivity.md)[/docs/project/principles/low_context_sensitivity.md],
which has the details.
Rationale based on Carbon's goals
This proposal supports the goal of making Carbon code easy to read, understand, and write particularly prioritizing "read and understand" over "write".
It supports software evolution by allowing code to be moved or refactored with fewer changes.
Further it supports developing performance-critical software in Carbon by making performance predictable.