Subject: [quicwg/base-drafts] 521828: Cite the notation section the first time it is used

From: Martin Thomson <[email-masked]>
Date: Tue, 03 Nov 2020 20:47:00 -0800

Branch: refs/heads/migration-amplification
  Home:   https://github.com/quicwg/base-drafts
  Commit: 5218286342445db502825c524a7dc2b839b3588b
      https://github.com/quicwg/base-drafts/commit/5218286342445db502825c524a7dc2b839b3588b
  Author: Martin Thomson <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Cite the notation section the first time it is used

Closes #4284.

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

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

  Log Message:
  -----------
  Describe inputs to the packet number algorithm

Closes #4297.

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

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

  Log Message:
  -----------
  Maximum datagram size of 1200 is a requirement

On endpoints.

Closes #4271.

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

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

  Log Message:
  -----------
  Glue

Co-authored-by: Jana Iyengar <[email-masked]>

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

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

  Log Message:
  -----------
  Yes, it's bytes

Closes #4303.

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

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

  Log Message:
  -----------
  Padding non-HOWTO

We explicitly don't recommend anything for defeating traffic analysis.
We only offer PADDING frames as they are known to be useful in existing
strategies.

Closes #4295.

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

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

  Log Message:
  -----------
  Explain what the bitfield references mean

Closes #4269.

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

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

  Log Message:
  -----------
  Moer txt

Co-authored-by: Jana Iyengar <[email-masked]>

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

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

  Log Message:
  -----------
  Tweak framing of frames table

Less detail above, but a pointer to what follows.

Closes #4299.

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

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

  Log Message:
  -----------
  is/are potato/tomato

Co-authored-by: Mike Bishop <[email-masked]>

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

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

  Log Message:
  -----------
  Tweaked suggestion

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

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

  Log Message:
  -----------
  Define stateless reset token

This was a little obtuse; it would benefit from a clearer description of
what the token is and how it is used.

Closes #4285.

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

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

  Log Message:
  -----------
  Mike's suggestions

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

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

  Log Message:
  -----------
  polish

Co-authored-by: Jana Iyengar <[email-masked]>

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

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

  Log Message:
  -----------
  Stop using initial timeout

Address validation can use 3*PTO, just taking the maximum of the old and
new path PTO.  The idea of initial timeout is easily replaced in
recovery by instead describing the effect on the PTO.  The net effect is
the same, except that new paths often have to include the maximum ACK
delay, which this doesn't incorporate.

Closes #4261.
Closes #4262.

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

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

  Log Message:
  -----------
  Remove formula with confusing variables

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

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

  Log Message:
  -----------
  initial RTO comparison

Co-authored-by: Jana Iyengar <[email-masked]>

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

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

  Log Message:
  -----------
  Add a definition for "frame"

I struggled with this a little.  Happy to take suggestions.

Closes #4266.

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

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

  Log Message:
  -----------
  Mike's suggestions, tweaked

Co-authored-by: Mike Bishop <[email-masked]>

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

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

  Log Message:
  -----------
  s/veyed/tained/

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

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

  Log Message:
  -----------
  Packets and datagrams and packets

Based on Jana's suggestion on #4313.

  Commit: 3abb3550658fcf6613b342b48c3da54079245c99
      https://github.com/quicwg/base-drafts/commit/3abb3550658fcf6613b342b48c3da54079245c99
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Packet number encoding in appendix, move examples

  Commit: 10310405803667cd0d6a0d0e1d9d738eadd396e5
      https://github.com/quicwg/base-drafts/commit/10310405803667cd0d6a0d0e1d9d738eadd396e5
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Expand example

  Commit: 9a50d2325c154d70cd15c364fc878557a538169e
      https://github.com/quicwg/base-drafts/commit/9a50d2325c154d70cd15c364fc878557a538169e
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Apply suggestions from code review

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

  Commit: afd5ac1f3346bdbb40432833d68e7db975b8aea6
      https://github.com/quicwg/base-drafts/commit/afd5ac1f3346bdbb40432833d68e7db975b8aea6
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Less python, more handwaving

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

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

  Log Message:
  -----------
  period

Co-authored-by: ianswett <[email-masked]>

  Commit: cc684115ded084d0d4c3a2a1c66792c51bb4470a
      https://github.com/quicwg/base-drafts/commit/cc684115ded084d0d4c3a2a1c66792c51bb4470a
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Truncatencode

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

  Commit: da88b361fc3c17d18345227283b895b465db6c25
      https://github.com/quicwg/base-drafts/commit/da88b361fc3c17d18345227283b895b465db6c25
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Restore the comment in the original text

  Commit: f03ef8f19120268de085d0a6a3e54ade96f13047
      https://github.com/quicwg/base-drafts/commit/f03ef8f19120268de085d0a6a3e54ade96f13047
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  VarInt decoding pseudocode

  Commit: fe4dd1b3d32c5e163b77c175f1bc7ebf47f3e1ff
      https://github.com/quicwg/base-drafts/commit/fe4dd1b3d32c5e163b77c175f1bc7ebf47f3e1ff
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Apply suggestions from code review

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

  Commit: daa679df4326653d1ea69bf31eefc9af69835745
      https://github.com/quicwg/base-drafts/commit/daa679df4326653d1ea69bf31eefc9af69835745
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Add comments

  Commit: f7f62c43b6ff62f60c885cc48ffcdc2456a031b5
      https://github.com/quicwg/base-drafts/commit/f7f62c43b6ff62f60c885cc48ffcdc2456a031b5
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Lars's comment

  Commit: 3eeeae99a1fb47373c504c35ac0bbd189f8fb82d
      https://github.com/quicwg/base-drafts/commit/3eeeae99a1fb47373c504c35ac0bbd189f8fb82d
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Expand for clarity

  Commit: 53ae7aebabf16b15da219c6437917fdcf7044ee0
      https://github.com/quicwg/base-drafts/commit/53ae7aebabf16b15da219c6437917fdcf7044ee0
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Move spin bit explanation to beginning of section

  Commit: c4e3d6df4bed21af62cdd5ae9bcb78e8a7e0b686
      https://github.com/quicwg/base-drafts/commit/c4e3d6df4bed21af62cdd5ae9bcb78e8a7e0b686
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Move overview to be first subsection

  Commit: ea17765dd7d15b2a5b02749350e50a170db9894e
      https://github.com/quicwg/base-drafts/commit/ea17765dd7d15b2a5b02749350e50a170db9894e
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Intro to Security Considerations

  Commit: 235072d159bd898170d7f17e1782a9e81c15c1ba
      https://github.com/quicwg/base-drafts/commit/235072d159bd898170d7f17e1782a9e81c15c1ba
  Author: Mike Bishop <[email-masked]>
  Date:   2020-11-04 (Wed, 04 Nov 2020)

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

  Log Message:
  -----------
  Martin's suggested intro, tweaked

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

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

  Log Message:
  -----------
  Establish normative force more directly.

This is right next to the BCP 14 text.

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

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

  Log Message:
  -----------
  Add pseudocode intro

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

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

  Log Message:
  -----------
  Reorder pseudocode sections

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

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

  Log Message:
  -----------
  plural

Co-authored-by: Mike Bishop <[email-masked]>

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

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

  Log Message:
  -----------
  Wrap

Compare: https://github.com/quicwg/base-drafts/compare/46bef9ece7eb...7808d2d27b65