Add a plain-language Why This Matters section before the principles - #12
Open
NetworkTheoryAppliedResearchInstitute wants to merge 1 commit into
Open
NetworkTheoryAppliedResearchInstitute wants to merge 1 commit into
NetworkTheoryAppliedResearchInstitute wants to merge 1 commit into
Conversation
The document opens with three dense paragraphs carrying Janus, Toffler, Acemoglu and Robinson's corridor, the Red Queen, two NTARI papers and the Leviathan in four forms, then goes straight into the principles. A reader who did not follow that theory had nothing to stand on. The new section states the argument once, in plain words, with no jargon and no citations, and hands off to the principles. Also trims a clause from the third introduction paragraph that duplicated the Shared Responsibility principle almost verbatim — both said the community that coordinates is the community that checks, and that the two are exchanged continuously. The principle keeps it; the paragraph now ends on the shackled Leviathan, which is what it was building toward. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Signed-off-by: the Institute <info@ntari.org>
Contributor
Author
|
Translations: after adoption. Required by CONTRIBUTING The English is authoritative and still under review. These seven amendments touch overlapping parts of the introduction, principles, layer bodies and references, so translating each separately would mean seven passes over seven languages against text that may still change in review. Recommend one translation pass covering every adopted amendment once this review closes. |
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.
First of the six review points: a summary of why this matters, before the principles.
The problem
The document opens with three dense paragraphs carrying Janus, Toffler, Acemoglu and Robinson's narrow corridor, the Red Queen effect, two NTARI papers and the Leviathan in four forms — then goes straight into the principles. A reader who did not follow that theory had nothing to stand on when the principles arrived.
The new section
No jargon, no citations, no terms of art. It restates in plain words what the three preceding paragraphs argue in theory —
not a check on paperis the paper Leviathan,a check that arrives late is not a check at allis the velocity gap — so the concepts stay available to a reader who skipped the apparatus.The trim, which needs your eye
The third introduction paragraph ended:
Compare the first principle, four paragraphs later:
That is the same sentence twice, near-verbatim, and adding a third plain-language statement of it would have made three. The principle keeps it, since that is where a reader looks for it. The paragraph now ends on the shackled Leviathan, which is what it was building toward:
The duplication predates this PR — worth flagging separately in case you would rather keep both and cut something else instead.
Remaining from this review
Economy & Information (E&I)at first use in each paragraph — still carries the open question that 9 paragraphs use it and none twice, so a strict per-paragraph rule retires the abbreviation entirely.🤖 Generated with Claude Code