docs: "spec" is the standard, not the document

[hanspagel]

hey, what a great project! it’s pretty common to use spec to refer to an OpenAPI file, we did this, too.

I’m super picky with wording, though and there is this a great OpenAPI glossary which helps here:
https://github.com/apisyouwonthate/api-glossary

TL;DR

• "spec" refers to the specification, the OpenAPI standard
• the file is what we call the OpenAPI document
• and the document contains an API definition

I mean, it’s not super horrible to go with "spec" (because most projects do), but on the other hand a new project is a great opportunity trying to fix that. :)

take from it what you want. just feedback from someone who is super picky with that stuff. ❤