style: referencing fields from other documents

[LPardue]

When one document references a field defined in another document, is there any preference of style? For example, should I say

• the "Content-Location" header field

• the "Content-Location" field

• the Content-Location header field

• the Content-Location field

• ...

[mnot]

I think it'd just be

the Content-Location header field [ref]

[mnot]

(on first occurrence)

[MikeBishop]

And what about pseudo-header fields? The style guide says no quotes except when defining for header fields, and I'm inclined to follow that, but the fact that pseudo-headers don't have a title-casing convention and begin with a non-letter character makes them feel substantially more awkward in the text. If nothing else, the style guide should explicitly cover that case.

[mnot]

How does that look?