Say in the first paragraph who may contribute - #196
Merged
Merged
Conversation
Record 0024 decides that this board takes experiments from anybody and fixes where the answer goes: the first paragraph of the guide, with the three rules a newcomer must have read linked from that paragraph. The guide carried neither, which #195 holds. The first paragraph now leads with the answer and links the three: what may never be committed, in record 0006 and again in the section below; what happens when an experiment finds a flaw in shipped software, in record 0010; and what an experiment may do with real data, in the privacy document, which is the one this board has not finished writing. The open one is marked as open rather than linked as though it were a rule. A link presented as a rule that turns out to be a deferral is worse than a sentence saying the rule is not written yet, and #35 is where the rest of it lands. The paragraph says that nothing here refuses a violation of any of the three, which is the sentence the placement exists for. The list further down already said it about itself, and a reader who never reaches the list is the reader the rule is about. Closes #195. Signed-off-by: Nils Lehnen <30603423+iderex@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #195
What this changes
The first paragraph of
CONTRIBUTING.mdleads with the answer record0024took, that this board takes experiments from anybody, and links the three rules
a newcomer must have read from that same paragraph: what may never be committed,
what happens when an experiment finds a flaw in shipped software, and what an
experiment may do with real data.
The third is marked as open rather than linked as though it were finished. The
privacy document carries what is settled and says that whether an experiment
here may touch real personal data at all is not settled there, and #35 is where
the rest of it lands. A link presented as a rule that turns out to be a deferral
is worse than a sentence saying the rule is not written yet.
The paragraph also says that nothing here refuses a violation of any of the
three. The list under
## What may never be committedalready says that aboutitself, and the reader this placement exists for is the one who never reaches
that list.
Means: an edit to the Markdown guide that already carries the rules, which is
where record
0024says the answer goes. It adds no file, no language and nodependency, and the paths it names are read by the invariants leg that already
refuses a document naming a path that is not there.
What failure it prevents
Somebody finding out after doing the work. Three rules on this board depend on a
person having read them before they start, nothing refuses a violation of any of
them, and somebody arriving for the first time is the person least likely to
have read them. Where the links sit is what decides whether they are read, and
they sat a hundred lines below the point where a reader decides whether this
board is for them.
It also prevents the narrower failure of a guide that reads as open while the
question of who may contribute is settled nowhere a contributor can see. That
question is now answered on the default branch in record
0024, and a guidethat does not carry it leaves the answer in a place a contributor has no reason
to open.
What was run
At
7664096bb5ab19c2b1d0988c12fa232951db3196, from the root of the checkout:Those two are the legs this change can move: the invariants leg refuses a
document naming a path that is not there, which is what four new links are, and
the prose leg reads the bytes around the words. The build, vet, gofmt and full
suite legs read Go source that this change does not touch, and they were not run
again at this commit.
This change removes no tracked path.
What this does not do
It does not make any of the three rules enforceable. Nothing here refuses a
violation of any of them, the paragraph says so, and moving where a rule is
linked changes nothing about what stands behind it.
It does not settle the third rule. What an experiment may do with real personal
data is open, and this paragraph links a document that says it is open rather
than one that answers it.
It does not touch the
## What may never be committedsection further down,which keeps its own copy of the list and its own statement that nothing refuses
a violation of it.
This board has no second reader tonight. What stands in place of one is the two
runs above at the pushed commit and the fact that every path this paragraph
names is judged by a check that refuses a path that is not there.