search

httpwg / admin

When you want to speak to the manager.
9 stars 15 forks source link

style guide: references #29

Closed LPardue closed 2 years ago

LPardue commented 2 years ago

https://github.com/httpwg/admin/blob/main/style-guide.md#references is IMO not very clear to a casual observer. I think it might just be better to state that named references are preferred over RFC numbers, and then list concrete examples of common documents that HTTP WG docs are likely to need. For instance, when referencing HTTP semenantics I think the preference is HTTP rather than SEMANTICS. Structured Fields will also similarly be referenced a lot and a common way to ref it might help things.

mnot commented 2 years ago

I was wondering if we should start a mini-registry of preferred names on the page...