Update schema.md

[niels-numbers]

I think by default one may would like to return the relations $post->author and not a single column $post->createdBy. Also createdBy is not a standard attribute, so I guess it was a typo?

[lindyhopchris]

This is intentional as it is showing that you don't need to call the JSON API relationship the same name as the model relationship. So I'm not sure about changing it?

[niels-numbers]

I see, but there are already existing examples in schema.md that show how to use custom attributes:

return [
          'comments' => [
              self::META => function () use ($post) {
                  return [
                      'total' => $post->comments_count,
                  ];
              },
          ],
      ];

[lindyhopchris]

Ah that's showing something different - that's showing meta, rather than returning the actual related resource.

[nelson6e65]

This was confusing for me when reading documentation. I was looking for a convention about createdBy as standard relationship 😅

[lindyhopchris]

Ok, thanks for the feedback all and I've merged this now.