Fix URI, Request target terminology.
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 28/100
- Tipo di issue
- Documentazione
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Ferma
- Stack tecnologico
- rust
- Ambito
- backend-api-design, documentation
Direzione di ricerca
Inizia dalla documentazione relativa all'attuale struttura Uri del crate e alla gestione di request-target, quindi esamina le issue correlate elencate nel report. Il lavoro è completato quando la terminologia descrive in modo coerente le forme di request-target e il cambiamento del nome pubblico ha una decisione esplicita sulla compatibilità prima dell'implementazione.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
As this crate stands for correctness, it is imperative to fix misleading terminology that is used through out the request-target handling documentation.
- Use
HttpRequestTargetinstead ofUri, as it really handles only request target forms, not identity scheme in any way. This may be difficult, noting it is a breaking change. Can alias and deprecate though. - In documentation of current
Uristruct, There is extensive use ofabsolute-uri/relative-uridichotomy to show that, forabsolute-uriit hasport,scheme, etc, and forrelative-uriit won't. This is grossly misleading. As this crate is not handling identifiers in the first place, there is no such thing asabsolute-uri/relative-uridichotomy. It is instead dichotomy ofabsolute-form/origin-formof request target. i.e, request-target inabsolute-formencodes port, scheme etc, and that inorigin-formdoesn't, as they have to be runtime-resolved. That's also the reason the mis-termedrelative-uris starts with a/, as they are not really identifiers, relative/absolute, butorigin-formresource targets.
The second point of fixing documentation may not be breaking change, and possible i hope.
We can see many misunderstandings due to this misleading. for example
- #127, As These are not identifiers, but representation of request-target values, there is no uri, and thus no fragments in first place.
- #465 Same mis-issue of using request-target representation to represent identifiers
- #469 They even mention other uri-schemes in issue discription, and also quotes uri-standard. Same mis-issue.
- #396 ,
urlcrate is for identifiers, where as this one only deals with request-targets. - #379 same issue. This crate doesn't handles uris in first place. only request targets.
- #342
- #311
- #323
- #421
- #306
- #176
- #110
so on, so forth.
For amount of confusion, ad misleading it creates, It may be helpful to fix at least terminology in docs, and fix Uri name for struct before 1.0
- Lingua principale
- Rust
- Stelle
- 1.4k
- Fork
- 378
- Merge medio
- 1g 21h
- PR unite (30g)
- 5
Guida per i contributori
Nessuna guida per i contributori indicizzata per questo repository
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di hyperium/http
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
-
Difficoltà 4/5 3-5 giorni Idoneità per principianti 45/100
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 62/100
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 58/100
-
Difficoltà 3/5 1-2 giorni Idoneità per principianti 62/100
Tutte le issue di hyperium/http
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 88/100
-
bug core
Difficoltà 2/5 1-3 ore Idoneità per principianti 86/100
-
JIT-compiled number -> Decimal conversion silently overflows instead of raising DECIMAL_OVERFLOW Apertafuzz
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
ClickHouse/ClickHouse#122114 ·
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 92/100
linebender/vello_svg#90 ·
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100