Improve documentation for `JoinAttrs`

[markuswustenberg]

It doesn't render correctly in the docs, see #262 (comment)

[markuswustenberg]

I think it's possible to create examples in the docs where everything is included? By putting the example in a file by itself. Will have to test.