Laurens Valk
f2346df4e5
pybricks.iodevices: Hide LWP3Device
...
This is not part of the upcoming release.
Hiding is nicer than adding not-ready disclaimers throughout, especially since this information is very easy to access via our beta channel.
2021-12-01 15:39:05 +01:00
Laurens Valk
94c659ba6d
pybricks.geometry: Hide module and IMU examples.
...
This is not part of the upcoming release.
Hiding is nicer than adding not-ready disclaimers throughout, especially since this information is very easy to access via our beta channel.
2021-12-01 15:39:04 +01:00
Laurens Valk
9c0298bad0
doc/main/index: Drop beta note.
...
This is a normal release.
2021-12-01 15:39:04 +01:00
Laurens Valk
602b21fe9d
doc/main/hubs: Hide Prime Hub.
...
This is not part of the upcoming release.
Hiding is nicer than adding not-ready disclaimers throughout, especially
since this information is very easy to access via our beta channel.
2021-12-01 15:39:04 +01:00
Laurens Valk
30803fc017
pybricks.robotics.DriveBase: Add curve method.
...
This generalizes motion to curves (arcs), which is in
between straight lines and in-place turns.
2021-12-01 15:38:27 +01:00
Laurens Valk
57f6f0fbef
pybricks.pupdevices.DCMotor: Document settings method.
...
Also update changelog for recent changes.
2021-12-01 14:55:34 +01:00
Laurens Valk
06a1542613
pybricks.pupdevices.DCMotor: Document settings method.
...
See https://github.com/pybricks/support/issues/536
2021-12-01 14:40:06 +01:00
Laurens Valk
82a8f2ae89
pybricks.pupdevices.Motor: Add small motor render.
...
Fixes https://github.com/pybricks/support/issues/441
2021-11-23 08:59:44 +01:00
Laurens Valk
7d0fe9cb85
doc/common/extensions: Fix classlink.
...
Allow the link to be different from the name.
This lets us fix the link for the Inventor Hub, which was linking to a non-existent page.
2021-11-22 14:49:20 +01:00
Laurens Valk
1af876ac8f
pybricks.pupdevices.ColorLightMatrix: Fix render.
...
- Use isometric projection
- Fix broken plug
- Use correct background color
While we are at it, add colors to show which 9 colors this device supports.
2021-11-22 14:49:20 +01:00
David Lechner
a2a375cb5c
docs/pupdevices: fix broken link
...
The link to the color light matrix page was broken due to an invalid
file name.
2021-11-19 20:28:33 -06:00
David Lechner
b6d1eef2a1
pybricks.iodevices.LWP3Device: add api and docs
...
This adds docs and API stubs for pybricks.iodevices.LWP3Device.
Fixes: https://github.com/pybricks/support/issues/534
2021-11-19 19:31:53 -06:00
David Lechner
20cb5fdde5
doc: make all titles sentence case
...
This makes the casing of titles consistent throughout the docs.
Fixes: https://github.com/pybricks/pybricks-api/issues/75
2021-11-19 19:30:57 -06:00
David Lechner
2f574e8c03
pybricks.pupdevices.ColorLightMatrix: add api and docs
...
This adds the SPIKE 3x3 Color Light Matrix to the API and docs.
2021-11-19 19:30:57 -06:00
David Lechner
9d8531a85b
npm/ide-docs: move npm packaging to separate directory
...
This makes a clean separation between the packaging and the docs.
2021-11-19 19:30:57 -06:00
David Lechner
fee122cf33
CHANGELOG: move to top level
...
This makes the CHANGELOG easy to find.
2021-11-19 16:37:38 -06:00
David Lechner
f42ed06d4f
doc/main/CHANGELOG: use keepachangelog.com recommendations
...
This updates the changelog to use keepachangelog.com recommendations
to make it consistent with other Pybricks changelogs.
2021-08-30 13:29:38 -05:00
David Lechner
a8126f0bed
doc/main: fix dir in package.json
...
Another case of a missed ide to main directory.
2021-08-30 12:20:44 -05:00
David Lechner
2c4685f594
doc/main: add TAG make option
...
This splits the Sphinx tag option from SPHINXOPTS. This allows us to
specify the tag without having to remember to add -W and -t. It also
fixes not being able to specify the tag with make.bat on Windows.
While we are touching this, redundant SOURCEDIR uses are removed (main
is already the default) and the .github/workflows/publish-ide-docs.yml
script is fixed (ide directory no longer exists).
2021-08-30 12:14:34 -05:00
David Lechner
8b0f98d25b
@pybricks/ide-docs v1.6.0
2021-08-30 11:12:05 -05:00
Laurens Valk
dd2e6e8603
ubuiltins.int: Document from_bytes manually.
...
Sphinx fails to show the docsting for class methods. Since we have very few of them, it is easier to just document this one manually
Fixes https://github.com/pybricks/pybricks-api/issues/86
2021-08-22 12:15:42 +02:00
Laurens Valk
d86b5584fb
ubuiltins: Type enumerate as a class.
...
This reverts commit a0ea0d8ca0 because of https://github.com/pybricks/pybricks-api/issues/72
2021-08-06 09:51:52 +02:00
Laurens Valk
1c01e981e0
usys: Clean up.
...
Add requirements, drop autodoc, and add a few cross references.
2021-08-05 16:13:50 +02:00
Laurens Valk
8a6ddf677c
pybricks.pupdevices.Remote: Light examples.
2021-08-05 14:56:00 +02:00
Laurens Valk
5d4481dbb0
pybricks.pupdevices.ColorDistanceSensor: Drop duplicate example.
2021-08-05 13:45:57 +02:00
Laurens Valk
b3c5353dd6
ubuiltins: Reorganize page.
...
Fixes https://github.com/pybricks/pybricks-api/issues/80
2021-08-05 12:32:41 +02:00
Laurens Valk
0ecf536cda
ubuiltins: Add compatibility everywhere.
...
This lets us sort everything by category or alphabetically without having to make special categories for Move Hub.
2021-08-05 12:32:37 +02:00
David Lechner
f2124615ba
ubuiltins: List decorators in separate section.
...
This moves the built-in decorators to their own section and uses
`autodecorator` to indicate they are decorators.
2021-08-05 12:32:29 +02:00
Laurens Valk
49ade9d9c6
pybricks.robotics: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
045312921e
pybricks.geometry: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
39f58b9e03
pybricks.tools: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
4945156d9a
pybricks.parameters: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
97b2de46ac
pybricks.hubs: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
979da8b170
pybricks.pupdevices: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
ac4a913be3
doc/common/requirements: Toggle hub table.
...
This makes it possible to hide/unhide the compatibility table.
It is adapted from the sphinxcontrib-contentui extension: https://github.com/ulrobix/sphinxcontrib-contentui
2021-08-05 12:32:03 +02:00
Laurens Valk
31a30f380f
doc/common/requirements: Rename to static.
...
We will work on a version that can be toggled dynamically. It will just include this static version. This keeps things simple and still lets
us use the static version as needed.
2021-08-05 12:32:03 +02:00
Laurens Valk
75bc15f071
ubuiltins: Add bytearray.
2021-08-05 12:32:03 +02:00
Laurens Valk
0b9280a8df
uerrno: Display on separate page.
...
Fixes https://github.com/pybricks/pybricks-api/issues/78
2021-08-02 11:01:20 +02:00
Laurens Valk
62bb262b96
pybricks.pupdevices.Remote: Add more examples.
2021-07-28 14:50:43 +02:00
Laurens Valk
8463206f8e
pybricks.pupdevices.Remote: Add name().
...
https://github.com/pybricks/support/issues/404
2021-07-28 13:41:00 +02:00
Laurens Valk
1cf6f8d31b
pybricks.iodevices: Document availability.
2021-07-27 15:55:38 +02:00
Laurens Valk
efc907fb0c
doc/main: Add hub compatibility icons.
...
Also render to git tree.
2021-07-27 14:56:11 +02:00
Laurens Valk
be0903de9e
doc/common/extensions: Basic styling.
...
Turns it into a table with images, using builtin RTD classes for CSS.
2021-07-26 15:47:02 +02:00
Laurens Valk
20361971da
doc/main/images: Crop City Hub.
...
This hub had extra whitespace so they were all the same height, but this is no longer needed in the current layout.
2021-07-26 15:03:42 +02:00
Laurens Valk
cefa78270a
doc/common/extensions: Add requirements directive.
...
Displays compatibility for each hub depending on its features.
2021-07-26 12:18:55 +02:00
Laurens Valk
1f5eb1790b
doc/main/package: Reenable warnings as errors.
...
This gets disabled when overriding SPHINXOPTS.
2021-07-23 15:59:33 +02:00
Laurens Valk
cb74f8e302
doc/main: Move signals to Pybricks TOC.
...
This was the only remaining section under "extras", so it is better to have it elsewhere. Since it only applies to the Pybricks package, put it there.
Also rename Pybricks Modules heading to Pybricks Package, since it behaves more like a package in contrast with the MicroPython modules that we now document as well.
2021-07-23 15:38:05 +02:00
Laurens Valk
24bba6d24c
pybricks.pupdevices.Motor: Document control here.
...
Based on user feedback, we learned that the control attribute is used more frequently than anticipated. Therefore it makes sense to document it here, just like we do with instances of pybricks.common classes in hubs.
This makes it a bit easier to find and see how it is used, along with some of the existing examples.
2021-07-23 15:33:18 +02:00
Laurens Valk
0edddbb0c2
pybricks.common.Control: Fix scale doc.
...
Document it as an attribute instead of in the main docstring. This way we can choose where it shows up in the docs.
2021-07-23 14:51:21 +02:00
Laurens Valk
a11af0845b
doc/main/motors: Drop commented sections.
...
This is not going to be completed here in the API docs.
2021-07-23 14:37:28 +02:00