docs/language/informal/README.md - Issue 2596933002: Add README for informal specs directory.

Side by Side Diff

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Keyboard Shortcuts

	File
u :	up to issue
j / k :	jump to file after / before current file
J / K :	jump to next file with a comment after / before current file
	Side-by-side diff
i :	toggle intra-line diffs
e :	expand all comments
c :	collapse all comments
s :	toggle showing all comments
n / p :	next / previous diff chunk or comment
N / P :	next / previous comment
<Up> / <Down> :	next / previous line

	Issue
u :	up to list of issues
j / k :	jump to patch after / before current patch
o / <Enter> :	open current patch in side-by-side view
i :	open current patch in unified diff view

	Issue List
j / k :	jump to issue after / before current issue
o / <Enter> :	open current issue

Side by Side Diff: docs/language/informal/README.md

Issue 2596933002: Add README for informal specs directory. (Closed)

Patch Set: Created 3 years, 12 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

OLD	NEW
(Empty)
	1 This directory contains "informal specifications".

	2

	3 In order to move faster and get better feedback, we implement and iterate on

	4 language changes before the full official specification has been written. Still,

	5 the implementers need something to go on.

	6

	7 For that, the language team writes "informal specifications". These are

	8 intended to be precise enough for a good faith implementer to correctly

	9 understand the syntax and semantics of the language, but without all of the

	10 laborious detail of the complete specification.

	11

	12 Once the feature has been implemented, tested, and we are confident in it, the

	13 language team will write the real text in the language specification and the

	14 document here becomes deprecated and no longer canonical.

	15

	16 Until then, while the feature is in progress, a live pull request for the

	17 informal spec is the source of truth for the feature.

OLD	NEW

« no previous file with comments | « no previous file | no next file » | no next file with comments »