This is why I’m not a fan of REST, the whole as possible part is meaningless. It could be an api that’s 99% REST with a few well thought out methods for common actions that aren’t quite REST, or it could be a mess of an api that uses PUT occasionally.
Self documenting at an application api level is not really possible. What I’d rather have is consistency and predictability, which is impossible in a REST as possible system.
Natural Selection 2 is still an awesome game with a pratically unique gameplay. It’s an RTS/FPS hybrid with asymmetrical teams. It’s worth checking out if you can handle a bit of a learning curve.