Prop271 spec: High level circuit creation and guard selection overview

This is to track additions to prop271 spec, specifically a section adding a 1000 foot overview.

changed milestone to %Tor: 0.3.0.x-final

added component::core tor/tor milestone::Tor: 0.3.0.x-final owner::chelseakomlo priority::low resolution::fixed review-group-15 reviewer::nickm severity::minor status::closed tor-spec type::enhancement version::tor unspecified labels

I have a patch at: git@github.com:chelseakomlo/torspec.git, branch prop271

Open questions are:

• How much information should be here versus other spec files?
• What should be defined in the glossary versus prop271?
• How much detail is necessary? I didn't include much information on the guard picking algorithm as I didn't want to have this section be redundant. But there is likely necessary info missing.

Trac:
Status: new to needs_review

Trac:
Milestone: Tor: unspecified to Tor: 0.3.0.x-final

LGTM. I think the section added is a fine overview section. Perhaps it can even be moved above section 2. State instances, so that it's beneath the motivation section like a true overview section would be.

WRT how much detail is necessary, I think it could be useful to include some further information on what it means to use a circuit or to let it wait. This has to do with how streams are assigned to circuits, and perhaps it would be useful for readers. Anyhow, this does not need to happen in this ticket; it's just some information that would have been useful to me when I originally read the proposal.

setting owner

Trac:
Status: needs_review to assigned
Owner: N/A to chelseakomlo

(asn, should this be merge_ready?)

Trac:
Status: assigned to needs_review

Trac:
Keywords: N/A deleted, review-group-15 added

Trac:
Reviewer: N/A to nickm

Trac:
Status: needs_review to merge_ready

merged!

Trac:
Resolution: N/A to fixed
Status: merge_ready to closed

Oh, great! Super fast, thanks everyone!

I will follow up on the items asn proposed above.

Consistently use tor-spec across all tickets (add tor-spec).

Trac:
Keywords: N/A deleted, tor-spec added

Consistently use tor-spec across all tickets (remove torspec).

Trac:
Keywords: torspec deleted, N/A added

closed

moved to tpo/core/tor#21193 (closed)