Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc standardization for networking spec #1338

Merged
merged 13 commits into from
Aug 9, 2019
Merged

doc standardization for networking spec #1338

merged 13 commits into from
Aug 9, 2019

Conversation

JSON
Copy link
Contributor

@JSON JSON commented Aug 5, 2019

Following up on #1039 and #1212 for the new networking spec doc, given many different writers involved!

Summary:

Added a title to it (just used the title of the doc's original PR #1328), stay-on-the-same-spec links, some British spelling instances converted to American (mostly -ised & -isation turned to -ized & -ization), grammatical commas, abbreviations Eth 2.0/Eth2.0/eth2.0/ETH 2.0/ETH2 standardized to “Eth 2.0” (except for in code snippets, which are left untouched), em dashes put in where they were intended to be used but an en dash was there (they look similar when editing, but not on the published doc), standardization when a recurring phrase is used (example: upon seeing "and then compressed with snappy" and "and subsequently compressed with Snappy" --> capitalizing Snappy and using the lighter "then" for both), other misc. edits

@JSON
Copy link
Contributor Author

JSON commented Aug 5, 2019

Caught some "behavioUrs" remaining (--> behavior) after the first commit, so I did a second/third look for anything missed the first time. Should be good for squashing into one commit now 👍

@hwwhww hwwhww added scope:networking general:proofread spelling, grammar, accuracy labels Aug 6, 2019
specs/networking/p2p-interface.md Outdated Show resolved Hide resolved
specs/networking/p2p-interface.md Outdated Show resolved Hide resolved
specs/networking/p2p-interface.md Outdated Show resolved Hide resolved
specs/networking/p2p-interface.md Outdated Show resolved Hide resolved
specs/networking/p2p-interface.md Outdated Show resolved Hide resolved
specs/networking/p2p-interface.md Outdated Show resolved Hide resolved
specs/networking/p2p-interface.md Outdated Show resolved Hide resolved
specs/networking/p2p-interface.md Outdated Show resolved Hide resolved
specs/networking/p2p-interface.md Outdated Show resolved Hide resolved
specs/networking/p2p-interface.md Show resolved Hide resolved
JSON and others added 10 commits August 7, 2019 11:20
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
@JSON
Copy link
Contributor Author

JSON commented Aug 7, 2019

Added @hwwhww's catches (thank you!)

@hwwhww hwwhww merged commit 5808ab3 into ethereum:dev Aug 9, 2019
djrtwo pushed a commit that referenced this pull request Aug 22, 2019
* Update p2p-interface.md

* Update p2p-interface.md

* Update p2p-interface.md

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
protolambda pushed a commit that referenced this pull request Aug 23, 2019
* Update p2p-interface.md

* Update p2p-interface.md

* Update p2p-interface.md

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>

* Update specs/networking/p2p-interface.md

Co-Authored-By: Hsiao-Wei Wang <hwwang156@gmail.com>
@JSON JSON deleted the patch-1 branch September 11, 2019 17:11
CarlBeek added a commit that referenced this pull request Sep 16, 2019
* dev: (25 commits)
  Update README.md
  Update README.md
  Update sync_protocol.md
  Update sync_protocol.md
  Update sync_protocol.md
  Deposit contract fixes (#1362)
  fix minor testing bug
  Update specs/networking/p2p-interface.md
  add note on local aggregation for interop
  Fix ssz-generic bitvector tests: those invalid cases of higher length than type describes, but same byte size, should have at least 1 bit set in the overflow to be invalid
  minor formatting
  Minor corrections and clarifications to the network specification
  doc standardization for networking spec (#1338)
  discuss length-prefixing pro/con, consider for removal, add link
  cleanups
  Updates
  apply more editorial suggestions.
  apply editorial suggestions.
  fmt.
  document doctoc command for posterity.
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
general:proofread spelling, grammar, accuracy scope:networking
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants