Commit Graph
10 Commits
Author SHA1 Message Date
Laurens Valk ce1ec1cb55 doc: copyediting 2019-01-24 15:52:00 +01:00
David Lechner cbefc64136 doc: add some Pybricks branding
This adds some Pybricks logos to the the generated docs .

The actual logos are quick hacks and should be revisited.
2019-01-20 19:10:26 -06:00
Laurens Valk 072ba814d7 doc: formatting
.

Remove empty pages

a few images were falling off the page because there wasn't any body text.
2019-01-18 16:50:07 +01:00
David Lechner cccc9f9b46 Merge branch 'travis' 2019-01-15 21:42:00 -06:00
David Lechner a15f3bc99a use versioneer for setting python package version
https://github.com/warner/python-versioneer

😋 🍪
2019-01-15 20:58:43 -06:00
Laurens Valk 39eab3230e doc: back to explicit ev3brick and ev3devices
(instead of brick and devices)

After internal discussion:
- This way we need to maintain only one fake API.
- Autocomplete can pick up the right brick/devices.
- Explicit is better than implicit.
2019-01-09 14:51:41 +01:00
Laurens Valk d5dedc7924 doc: autodoc for init
test syntax for autolinking to types
test syntax to avoid evaluating enum arguments to numbers
2018-12-28 16:40:01 +01:00
Laurens Valk fe82313bde fake-api: parameters module (experimental)
Fix EV3 colors after recent pbio update

And make sphinx compile (but not much more)
2018-12-21 17:44:43 +01:00
David Lechner 54baebc1f5 doc: experimenting with autodoc generation
Observations:

* Type annotations tend to be verbose, for example:

        blink(color1: typing.Union[pblight.Color, pblight.RGB, NoneType], color2: typing.Union[pblight.Color, pblight.RGB, NoneType], pattern: pblight.Pattern) → None

* There seems to be a bug with .. autodata::
2018-09-07 20:53:03 -05:00
David Lechner e44d08a0f0 doc: relocate doc build files 2018-09-07 17:29:41 -05:00