fix rendering of tables in docstrings

[hoefling]

Signed-off-by: oleg.hoefling [email protected]

[Cito]

Thank you for these fixes!

[hoefling]

@Cito gladly! Would you mind accepting more improvements for docstrings? I have noticed some usage of single backticks clearly intended to render verbatim blocks, e.g. __typename here or extend_schema (here). Also, some docstrings could have more internal crossrefs, e.g. graphql.parse_value could benefit from adding crossrefs to GraphQLError and value_from_ast etc.

[Cito]

@hoefling Sure, I'd appreciate any help with that. Actually I mostly just copied the docstrings which were written for JSDoc without thinking much about how they render with Sphinx and ReST. Maybe we can also make use of newer autodoc features - I haven't looked into that yet.