AtomPub is designed to define clear relations between resources in REST and allow for typing of data fields, but nobody really uses it (Google's Data API used to, but most of it is deprecated nowadays). So, do people just use a pragmatic approach and document the API manually, or is there something fundamentally wrong with AtomPub, beside failing to gain a critical audience?