For example, a "write access disallowed" problem is probably unnecessary, since a 403 Forbidden status code in response to a PUT request is self-explanatory.

The link name is not very helpful, it doesn’t explain what it does very well.

One last bonus: CSS variables can be written in a way that makes it easier for human programmers to understand. If you just see hex code #93e9be, you won’t know what color it produces, while --brand-green makes clear the purpose of the variable.

My focus is on make the API as simpler as possible to allows easy integration without even reading the docs but keeping and expand current features.