Missing/incomplete getting started guide sections

[joshsloat]

Ahead of making the switch to Pybricks, I started reading the getting started guide here

This guide appears to be fleshed out for Sections 1-3, but makes reference to many sections I don't see linked to anywhere. These sections include:

4. Waiting, repeating, and tasks
5. Making decisions with sensors
6. Using logic to make combined decisions
7. The color sensor
8. Using motors effectively
9. Navigation with the gyro sensor
10. Creating and using variables
11. Creating and using tasks and functions
12. Using lists and iterations
13. Wireless communication

This all sounds like very helpful information. The Chapter Overview says, "This guide is broken down into several main parts. We start with the basics, and gradually build on the skills you learn throughout." Parts 1-3 seem to be there for the most basic concepts, but 4-13 simply make reference to more advanced topics without actually linking to pages or providing the actual expected content. Is this a work in progress, where 4-13 are just referring to documentation that will someday exist? Or am I missing something?

[laurensvalk]

Thanks for raising this! The remaining chapters are a work in progress, but we're slightly overwhelmed with various feature requests at the moment 🙂 We hope to be getting back to this soon.

[joshsloat]

Thanks @laurensvalk. Since this is so top of mind for my group, we're happy to help review, proof, etc if helpful when the time comes.

[laurensvalk]

Thank you!

In the mean time, please do feel free to start any new discussions with questions on this forum. The community is usually happy to help.

[laurensvalk]

maybe chatgpt can help us out?

Writing good user guides may become a lost art. AI is useful for many things, but this is not one of them.

You're welcome to use AI as you like, but we are not encouraging its use to generate consistent information. Just a quick glance at this shows several glaring errors in this post. It's still there, but I've minimized it to avoid confusion. Hope that's OK.

---

This doesn't even exist:

hub.system.run

I'll leave it as homework to see what's wrong here.

from pybricks.hubs import PrimeHub
from pybricks.pupdevices import Motor
from pybricks.parameters import Port
from pybricks.tools import wait

hub = PrimeHub()
motor = Motor(Port.A)

def turn(degrees):
    target = hub.imu.angle() + degrees
    while abs(target - hub.imu.angle()) > 5:
        motor.run(100)
    motor.stop()

turn(90)  # Turn 90 degrees

[joshsloat]

This approach also isn't as friendly for those using Blocks and the existing guides are phenomenal in that regard.

[zoligyenge]

You are right, it was just a quick idea....