Rename "related" #478
Description
I am not positive that my feeling of English is adequate here, but I think related in links is somewhat confusing because the meaning of the word "related" is too broad: it may be perceived as something generally related, as opposed to the object being referred to by the relationship. So I suggest to replace it with referred (refers or reference might also work).
Before:
{
"type": "articles",
"id": "1",
"title": "Rails is Omakase",
"links": {
"self": "http://example.com/articles/1",
"author": {
"self": "http://example.com/articles/1/links/author",
"related": "http://example.com/articles/1/author",
"linkage": { "type": "people", "id": "9" }
}
}
}After:
{
"type": "articles",
"id": "1",
"title": "Rails is Omakase",
"links": {
"self": "http://example.com/articles/1",
"author": {
"self": "http://example.com/articles/1/links/author",
"referred": "http://example.com/articles/1/author",
"linkage": { "type": "people", "id": "9" }
}
}
}#477 can be viewed as a further improvement in this area.