Docs Refresh

[willmcgugan]

Please don't proof read the docs just yet. Will request that in a later updated

• Updated mkdocs and associated libs
• Defines a structure in the docs
• Adds a few docs, and a mkdocs plugin to render a screenshot to SVG
• Removes style parameter from render method
• Fixes issue with simple case of widget on an App

[olivierphi]

Awesome! 😍

As we were discussing, it could be nice to get rid of that odd spacing in the API documentation headers:

It seems that just setting line-height: 1; to a h2.doc.doc-heading selector does the job?

(it seems that we can simply add a extra.css file in the docs folder make it be picked automatically by MKDocs? - doc)

[darrenburns]

@drbenton I actually like how far apart the text is at the moment, it was just the fact that there was the gaps in the colour behind the text that I thought was a little jarring 😄

[willmcgugan]

There is definitely room for tweaking those API reference pages. They don't look great. Will come back to it.

[pawamoy]

There are some options you could use to tweak the rendering of API reference, given you are using the new handler and not the legacy one:

- mkdocstrings:
    handlers:
      python:
        selection:
          docstring_style: google
          docstring_options:
            ignore_init_summary: yes
        rendering:
          merge_init_into_class: yes
          separate_signature: yes
          line_length: 80

If Black is installed, the signatures are formatted, respecting the specified line length.

[willmcgugan]

Thanks Timothée!