summaryrefslogtreecommitdiff
path: root/docs/proposals/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/proposals/README.md')
-rw-r--r--docs/proposals/README.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/proposals/README.md b/docs/proposals/README.md
new file mode 100644
index 000000000..9df8052c4
--- /dev/null
+++ b/docs/proposals/README.md
@@ -0,0 +1,8 @@
+Proposals
+=========
+
+This directory contains proposals / "RFCs" for Slang language/compiler/system features.
+In general, proposals are used for features that are large or complicated enough that the design and/or plan benefits from being discussed in detail before we commit to making code changes.
+
+Design *discussion* can often be facilitated by a GitHub/GitLab issue, or PR review comments, but often it is difficult for a developer to get a clear summary of the final decisions/POR without reading an entire discussion thread.
+By framing design discussion around a document that captures the decisions, we hope to ensure that the at the end of the discussion we have useful collateral for anybody who goes to implement a feature.