Commit Graph
39 Commits
Author SHA1 Message Date
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
David Lechner 48d795ea08 doc: add dummy file so we stop getting warnings
This prevents warnings about the _static directory not existing. We will probably want to override something eventually, so adding an empty file rather than removing it from conf.py.
2019-01-20 19:02:33 -06:00
Laurens Valk 18652e0639 doc: update robot arm name and references 2019-01-19 18:22:01 +01:00
Laurens Valk 1918adf7b4 doc: remove vscode instructions for first release
add examples instead

users can use their favorite method of getting the examples or their own scripts to the brick
2019-01-19 17:31:45 +01:00
Laurens Valk 0a8cb055b2 doc: drop features that won't be implemented for first release
Combined with previous comments, this closes #91
2019-01-18 17:19:19 +01: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
Laurens Valk 188dbf0e7d doc: update ev3dev link 2019-01-17 23:14:33 +01:00
Laurens Valk 98adc2edb1 doc: placeholder run diagrams 2019-01-17 21:05:13 +01:00
Laurens Valk 3b8e9bfda1 doc: very rough installation steps 2019-01-17 19:38:50 +01:00
Laurens Valk 23d5e582e3 doc: extend table of contents 2019-01-17 11:26:13 +01:00
Laurens Valk 8a133b8101 doc: test instructions 2019-01-16 21:29:19 +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 7867704514 bricks/ev3dev: move print to tools 2019-01-13 18:37:00 +01:00
Laurens Valk 5381f528f5 extmod: Make light function and doc match
For now, do not implement features such as brightness and patterns.
2019-01-13 18:10:22 +01:00
Laurens Valk 9e65c7eabc extmod: implement run_until_stalled with variable limits 2019-01-12 12:02:39 +01:00
Laurens Valk 4c74eff39f doc: group motor methods by rubric 2019-01-11 09:03:18 +01:00
Laurens Valk 5327611ac0 doc: motor debug, dc, and tracking api 2019-01-10 10:31:26 +01: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 2f0d7ec0a2 doc: brick, sound, display, and experiment with samples 2019-01-04 15:05:17 +01:00
Laurens Valk 3da8785995 doc: rough draft EV3 brick 2019-01-03 19:44:10 +01:00
Laurens Valk 02bee5766f doc: tools
need to test StopWatch after this modification
2019-01-03 19:06:04 +01:00
Laurens Valk 3873a20497 doc: motor draft 2019-01-03 13:54:47 +01:00
Laurens Valk c5288d34ac doc: some organization and toc 2018-12-31 12:54:04 +01:00
Laurens Valk 56364997a2 doc: motor settings and most ev3 sensors
Note: the motor code will be updated accordingly once updated API is considered final.
2018-12-31 12:15:09 +01:00
Laurens Valk 7c106e2444 doc: experiment with signal types 2018-12-29 13:02:59 +01:00
Laurens Valk 26f0ee02ea doc: hide enum numbers, document members instead
We should not encourage users to use the numerical values (i.e. 2 for Stop.hold or 65 for Port.A)

This also keeps the door open for using qstrings for some enums (Color, Button).
2018-12-28 18:00:02 +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 e94b54c380 doc: experiment with tables and ascii art
Sphinx and read the docs seem to require RST. This works well for this sample code.

Unfortunately, vscode code preview seems to require markdown (For the tables. Other RST seems to work.)
2018-12-21 21:31:40 +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
Laurens Valk 7e1139f195 doc: use flowchart instead of table 2018-10-20 13:59:24 +02:00
Laurens Valk 044dddfec1 doc: starting point for yable of user actions 2018-10-19 20:42:49 +02:00
Laurens Valk 95a8d12058 design: programming 2018-10-19 14:02:32 +02:00
Laurens Valk aa65ce6b54 formatting: normalize line endings for make.bat
Unable to discard this locally, testing if committing this fixes it.
See comments on 2163a0eef77cdf95087813a363f056efd7472243
2018-10-18 11:19:38 +02: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
David Lechner d8533cb6bc pbio: split low-level I/O dirvers from high-level library
The eventual goal here is that the pbdrv functions will be the absolute minimim needed to do the actual I/O to the hardware. Everything else should be implemented in the main library.
2018-09-07 16:47:36 -05:00
David Lechner dad155641e doc: set doxygen for pbio library 2018-09-06 19:54:07 -05:00
David Lechner 634d5595d0 doc: set up a doc template with a few random items 2018-09-06 16:22:44 -05:00