Subject: [quicwg/base-drafts] b38da3: Editorial: More concise intro text

From: Martin Thomson <[email-masked]>
Date: Tue, 03 Mar 2020 19:44:50 -0800

Branch: refs/heads/max_udp_size-0rtt
  Home:   https://github.com/quicwg/base-drafts
  Commit: b38da3b5b3f6de626ce324cd91226fb0ade25aa0
      https://github.com/quicwg/base-drafts/commit/b38da3b5b3f6de626ce324cd91226fb0ade25aa0
  Author: mirjak <[email-masked]>
  Date:   2020-01-22 (Wed, 22 Jan 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Editorial: More concise intro text

Just a proposal but I would prefer to remove the advertising slang ("decades of transport and security experience" and "makes it attractive").

  Commit: f458ac8271c7e50e1111794d454e52eee9bf590f
      https://github.com/quicwg/base-drafts/commit/f458ac8271c7e50e1111794d454e52eee9bf590f
  Author: mirjak <[email-masked]>
  Date:   2020-01-23 (Thu, 23 Jan 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Update draft-ietf-quic-recovery.md

Co-Authored-By: Jana Iyengar <[email-masked]>

  Commit: 26a38dd8278fb208ff2610fc5b2aae5ec671206b
      https://github.com/quicwg/base-drafts/commit/26a38dd8278fb208ff2610fc5b2aae5ec671206b
  Author: mirjak <[email-masked]>
  Date:   2020-01-23 (Thu, 23 Jan 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Update draft-ietf-quic-recovery.md

Co-Authored-By: Jana Iyengar <[email-masked]>

  Commit: d8d72ab1e2c156657bc06f07f36585c66bdb06da
      https://github.com/quicwg/base-drafts/commit/d8d72ab1e2c156657bc06f07f36585c66bdb06da
  Author: Jana Iyengar <[email-masked]>
  Date:   2020-01-24 (Fri, 24 Jan 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Update draft-ietf-quic-recovery.md

  Commit: 8c52fd83cb5a0228dd696e45f556617e8156036f
      https://github.com/quicwg/base-drafts/commit/8c52fd83cb5a0228dd696e45f556617e8156036f
  Author: ianswett <[email-masked]>
  Date:   2020-02-09 (Sun, 09 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Clarify client anti-amplification response

Clarifies why a client might send a Handshake packet, as well as generally tries to improve the anti-deadlock text.

Fixes #2598

  Commit: 6138a07267ab9a28d00eaec8f3699cf60a6dc7fe
      https://github.com/quicwg/base-drafts/commit/6138a07267ab9a28d00eaec8f3699cf60a6dc7fe
  Author: ianswett <[email-masked]>
  Date:   2020-02-09 (Sun, 09 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

  Commit: 2793b5c477c8ef4672c5d056510d685f83b0bf90
      https://github.com/quicwg/base-drafts/commit/2793b5c477c8ef4672c5d056510d685f83b0bf90
  Author: ianswett <[email-masked]>
  Date:   2020-02-09 (Sun, 09 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Simplify

  Commit: a6e821584e80f2fa5efe02a21aba0926131d7a4d
      https://github.com/quicwg/base-drafts/commit/a6e821584e80f2fa5efe02a21aba0926131d7a4d
  Author: ianswett <[email-masked]>
  Date:   2020-02-09 (Sun, 09 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

  Commit: 321c59afbcf01afa80373633c9ec2058a9088cf8
      https://github.com/quicwg/base-drafts/commit/321c59afbcf01afa80373633c9ec2058a9088cf8
  Author: ianswett <[email-masked]>
  Date:   2020-02-10 (Mon, 10 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Reworked Martin's suggestion

  Commit: 86ae5b47c6f73a1356b211cf4db0a6b2dcd23d85
      https://github.com/quicwg/base-drafts/commit/86ae5b47c6f73a1356b211cf4db0a6b2dcd23d85
  Author: ianswett <[email-masked]>
  Date:   2020-02-15 (Sat, 15 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Martin's suggestion reworded

  Commit: 6fa5c4286429fd28fd5447936214d37d50b6f2c0
      https://github.com/quicwg/base-drafts/commit/6fa5c4286429fd28fd5447936214d37d50b6f2c0
  Author: ianswett <[email-masked]>
  Date:   2020-02-15 (Sat, 15 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Clarify adaptive loss thresholds

Fixes #3389 by clarifying that one may start with a smaller time threshold, not a smaller packet threshold.

  Commit: 275ab8038214c051d9e767d43c08a2f9b3f042bd
      https://github.com/quicwg/base-drafts/commit/275ab8038214c051d9e767d43c08a2f9b3f042bd
  Author: ianswett <[email-masked]>
  Date:   2020-02-15 (Sat, 15 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Make congestion control more self-contained

Clarifies a few points and moves the initial window recommendation from the pseudocode to the text.

Fixes #3088

  Commit: 7660a51226fe6ba10b0793a88466954b0210e580
      https://github.com/quicwg/base-drafts/commit/7660a51226fe6ba10b0793a88466954b0210e580
  Author: ianswett <[email-masked]>
  Date:   2020-02-19 (Wed, 19 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Separate out initial and min congestion window

  Commit: b8779343f9b51d7d5435b5cd3e6d0bece516b329
      https://github.com/quicwg/base-drafts/commit/b8779343f9b51d7d5435b5cd3e6d0bece516b329
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-22 (Sat, 22 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Remove tabs from recovery draft

  Commit: 15612646cc9e36ade7043fc93c4114c0221712c7
      https://github.com/quicwg/base-drafts/commit/15612646cc9e36ade7043fc93c4114c0221712c7
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-22 (Sat, 22 Feb 2020)

  Changed paths:
    M .lint.py

  Log Message:
  -----------
  Lint HTAB

I caught Ian adding these once, then failed to catch it a second time.
Fool me once...

  Commit: 96a64024ce8a2cbb5e9ab58de4180ed53166fc3a
      https://github.com/quicwg/base-drafts/commit/96a64024ce8a2cbb5e9ab58de4180ed53166fc3a
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-24 (Mon, 24 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Remove tabs from recovery draft

  Commit: 69c2d95035420cc9bc596ed1d6a3373dfbe85548
      https://github.com/quicwg/base-drafts/commit/69c2d95035420cc9bc596ed1d6a3373dfbe85548
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-24 (Mon, 24 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Transport parameters can be declared unilaterally

The text already says this, but we lost track of it.  This hopefully
clarifies that.

Closes #3429.

  Commit: e28286096182fa8b57a8607da90ce73144b3f105
      https://github.com/quicwg/base-drafts/commit/e28286096182fa8b57a8607da90ce73144b3f105
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-24 (Mon, 24 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  ^^

  Commit: d38e8c0f0d7376c66a1c0c64111177879321cb50
      https://github.com/quicwg/base-drafts/commit/d38e8c0f0d7376c66a1c0c64111177879321cb50
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-24 (Mon, 24 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Scope connection IDs to the current connection

This isn't strictly necessary, as it might be implied by the definition
of a connection ID.

Closes #3484.

  Commit: f9b64c275b366d0b745340da92d0ad019d48ce25
      https://github.com/quicwg/base-drafts/commit/f9b64c275b366d0b745340da92d0ad019d48ce25
  Author: Dmitri Tikhonov <[email-masked]>
  Date:   2020-02-24 (Mon, 24 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Fix typo in transport draft changelog

  Commit: 2ce00d0f25b338bbc3a917805fb06d477edfacc1
      https://github.com/quicwg/base-drafts/commit/2ce00d0f25b338bbc3a917805fb06d477edfacc1
  Author: Bence Béky <[email-masked]>
  Date:   2020-02-25 (Tue, 25 Feb 2020)

  Changed paths:
    M draft-ietf-quic-qpack.md

  Log Message:
  -----------
  Improve language on evictable entries. (#3131)

* Improve language on blocking entries.

Remove "insertion has been acknowledged" phrase to avoid confusion
between Header Acknowledgement instructions implicitly acknowledging
encoder stream instructions and explicitly acknowledging header blocks.
Use Known Received Count instead.

Clarify that references on the encoder stream do not block an entry from
eviction.  Trivial as it is, I overlooked this at first, and added quite
some unnecessary complexity that was eventually removed at
https://quiche.googlesource.com/quiche/+/b09d44167c543b80b2c27408dd1f9df3b07c9741.
My motivation here is to help future implementers to avoid this pitfall.

Merge redundant Reference Tracking section into Blocked Dynamic Table
Insertions.

Change style of "Note" at end of section for consistency.  There were
already four sentences starting with "Note that" throughout the draft
before this PR (now there are six), but no other "Note:" markdown.

* Revert changing acknowledging insertion to comparing absolute index to Known Received Count.

* Remove unnecessary wordcrafting to blocked-insertion first paragraph.

* wordsmithing

* nit

* Minor rewording

  Commit: 9e0d7e7cd162c942e9a756f0dbf143f3ff311447
      https://github.com/quicwg/base-drafts/commit/9e0d7e7cd162c942e9a756f0dbf143f3ff311447
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-25 (Tue, 25 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge pull request #3481 from dtikhonov/202002241022-fix-transport-changelog-typo

Fix typo in transport draft changelog

  Commit: 86f72a783870cb18d6ad334d4edac1f08f7a1f79
      https://github.com/quicwg/base-drafts/commit/86f72a783870cb18d6ad334d4edac1f08f7a1f79
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-25 (Tue, 25 Feb 2020)

  Changed paths:
    M .lint.py

  Log Message:
  -----------
  Merge pull request #3476 from quicwg/lint-tab

Lint tabs

  Commit: 4a202220895c6d2fb9d1cb81a2ecee6eab69cfb0
      https://github.com/quicwg/base-drafts/commit/4a202220895c6d2fb9d1cb81a2ecee6eab69cfb0
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-25 (Tue, 25 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge pull request #3478 from quicwg/unilateral-tp

Unilateral Transport Parameters

  Commit: 51fdf4251200fb0daf02d2014e6be72e4683f413
      https://github.com/quicwg/base-drafts/commit/51fdf4251200fb0daf02d2014e6be72e4683f413
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-25 (Tue, 25 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge pull request #3485 from quicwg/connection-scope-id

Scope connection IDs to the current connection

  Commit: d71905f1cccff82204ee98afb9c4532be3348541
      https://github.com/quicwg/base-drafts/commit/d71905f1cccff82204ee98afb9c4532be3348541
  Author: ianswett <[email-masked]>
  Date:   2020-02-25 (Tue, 25 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Merge pull request #3462 from quicwg/ianswett-adaptive-loss

Clarify adaptive loss thresholds

  Commit: 6d5f3dab6470062bf3649872b3fe21498710dbf6
      https://github.com/quicwg/base-drafts/commit/6d5f3dab6470062bf3649872b3fe21498710dbf6
  Author: Dmitri Tikhonov <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-http.md

  Log Message:
  -----------
  Fix typo in HTTP draft (#3482)

  Commit: bf46a9b1e6bc81dc0cda1ef84f4c0b440702b872
      https://github.com/quicwg/base-drafts/commit/bf46a9b1e6bc81dc0cda1ef84f4c0b440702b872
  Author: Loganaden Velvindron <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-http.md

  Log Message:
  -----------
  HTTP/3: Add RFC8446 reference for TLS 1.3. (#3483)

* Add RFC8446 reference

* Fix formatting reported by CircleCI

* Fix trailing whitespaces

* Use  symbolic references

Co-Authored-By: Martin Thomson <[email-masked]>

* Use symbolic reference for TFO

Co-Authored-By: Martin Thomson <[email-masked]>

* Fix line wrapping

Co-authored-by: Martin Thomson <[email-masked]>

  Commit: 55d617658fd32b95c54f27e75d1bab5739032537
      https://github.com/quicwg/base-drafts/commit/55d617658fd32b95c54f27e75d1bab5739032537
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Jana's suggestions

Co-Authored-By: Jana Iyengar <[email-masked]>

  Commit: 9124ab1f5e462d386eec478e3813cfccec00148a
      https://github.com/quicwg/base-drafts/commit/9124ab1f5e462d386eec478e3813cfccec00148a
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

  Commit: 0ce17f386f32e69c5e1abeaaddaccc273e4e110c
      https://github.com/quicwg/base-drafts/commit/0ce17f386f32e69c5e1abeaaddaccc273e4e110c
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

  Commit: 52649b9ecb3d4ddf3325e5db8891e7a2e6d95813
      https://github.com/quicwg/base-drafts/commit/52649b9ecb3d4ddf3325e5db8891e7a2e6d95813
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

  Commit: 1bc588fe9dc0227b2aeda8a6311f22ea7c2157a2
      https://github.com/quicwg/base-drafts/commit/1bc588fe9dc0227b2aeda8a6311f22ea7c2157a2
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

  Commit: 1a952f91d3f8d371e5fadfb2a56fb8c63ff6d5de
      https://github.com/quicwg/base-drafts/commit/1a952f91d3f8d371e5fadfb2a56fb8c63ff6d5de
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

  Commit: 1e60a825e535c3d1fddff7c3121b60a9bae1db40
      https://github.com/quicwg/base-drafts/commit/1e60a825e535c3d1fddff7c3121b60a9bae1db40
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

  Commit: b19b38b5fcb9e4c24fbdf95328fa7f6c726a5180
      https://github.com/quicwg/base-drafts/commit/b19b38b5fcb9e4c24fbdf95328fa7f6c726a5180
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Update draft-ietf-quic-transport.md

  Commit: 47ba99c5eba017e53d1fd1b01cc8d6386cdffbd3
      https://github.com/quicwg/base-drafts/commit/47ba99c5eba017e53d1fd1b01cc8d6386cdffbd3
  Author: Martin Thomson <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-transport.md

  Log Message:
  -----------
  Merge pull request #3445 from quicwg/ianswett-why-send-handshake

Clarify client anti-amplification response

  Commit: 4fc37067f5cb3d62b59b3bd48fac75d5c09a4b36
      https://github.com/quicwg/base-drafts/commit/4fc37067f5cb3d62b59b3bd48fac75d5c09a4b36
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  MT's comments and minimize text in the appendix

  Commit: 0f2d4bff92a79bf4a385ff5992c7d6d403cbdd4f
      https://github.com/quicwg/base-drafts/commit/0f2d4bff92a79bf4a385ff5992c7d6d403cbdd4f
  Author: ianswett <[email-masked]>
  Date:   2020-02-26 (Wed, 26 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Update draft-ietf-quic-recovery.md

  Commit: 70b56f694d81348b1faabdb289050266cc46e9ba
      https://github.com/quicwg/base-drafts/commit/70b56f694d81348b1faabdb289050266cc46e9ba
  Author: Jana Iyengar <[email-masked]>
  Date:   2020-02-27 (Thu, 27 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Merge pull request #3463 from quicwg/ianswett-cc-self-contained

Make congestion control more self-contained

  Commit: 206ae8519c0eca337314a958ab181b9255b98643
      https://github.com/quicwg/base-drafts/commit/206ae8519c0eca337314a958ab181b9255b98643
  Author: Jana Iyengar <[email-masked]>
  Date:   2020-02-27 (Thu, 27 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Update draft-ietf-quic-recovery.md

  Commit: bde607e16fd14e3d8a82035d7f5e6b8a8ba43d18
      https://github.com/quicwg/base-drafts/commit/bde607e16fd14e3d8a82035d7f5e6b8a8ba43d18
  Author: Jana Iyengar <[email-masked]>
  Date:   2020-02-27 (Thu, 27 Feb 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Merge pull request #3380 from mirjak/patch-5

Editorial: More concise intro text (recovery)

  Commit: 062b95580c1371f31d30314e016a9ed85ea67f87
      https://github.com/quicwg/base-drafts/commit/062b95580c1371f31d30314e016a9ed85ea67f87
  Author: mirjak <[email-masked]>
  Date:   2020-03-03 (Tue, 03 Mar 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Normative language in cc section

This my need a design issue because I suggest to use two SHOULDs instead of should. However, I would first like to get some feedback if people agree.

  Commit: eb65124854433637e827f68c4b40380c6c301ab1
      https://github.com/quicwg/base-drafts/commit/eb65124854433637e827f68c4b40380c6c301ab1
  Author: ianswett <[email-masked]>
  Date:   2020-03-03 (Tue, 03 Mar 2020)

  Changed paths:
    M draft-ietf-quic-recovery.md

  Log Message:
  -----------
  Merge pull request #3492 from mirjak/patch-22

Normative language in cc section

  Commit: a356f032a97ea2619e6b991d054c0850b7151a4a
      https://github.com/quicwg/base-drafts/commit/a356f032a97ea2619e6b991d054c0850b7151a4a
  Author: Martin Thomson <[email-masked]>
  Date:   2020-03-04 (Wed, 04 Mar 2020)

  Changed paths:

  Log Message:
  -----------
  Merge branch 'master' into max_udp_size-0rtt

Compare: https://github.com/quicwg/base-drafts/compare/c9f76ff2a7ac...a356f032a97e