Skip to content

User/brianwei15/create first mode tutorial - #429

Merged
brianwei15 merged 10 commits into
mainfrom
user/brianwei15/create-first-mode-tutorial
Sep 5, 2026
Merged

User/brianwei15/create first mode tutorial#429
brianwei15 merged 10 commits into
mainfrom
user/brianwei15/create-first-mode-tutorial

Conversation

@brianwei15

@brianwei15 brianwei15 commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Issue(s) addressed:
Resolves #428, closes #384

Description:

  • added create your first mode tutorial consisting of a navGPSMode-like walkthrough
  • added concepts section to documentation explaining modes, missions, and mode manager

Testing Done:

  • can see on website

Comment on lines +109 to +116
@register_mode(
id="uav.FlyToPointMode",
params_cls=FlyToPointParams,
targets=[UAV],
transition_labels=["complete"],
)
class FlyToPointMode(Mode[UAV, FlyToPointParams]):
"""Fly a UAV to one position in its local NED frame."""

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It could be useful to use sphinx-directives that point to our python autoapi, which displays the docstrings within the actual method defintion. Can also apply to explanations of the API elsewhere

Not blocking for this PR tho

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bumping to #435


.. code-block:: text

controls/sae_2025_ws/src/uav/uav/modes/FlyToPointMode.py

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

vote to change the filename to fly_to_point_mode.py

I have an issue #335 to eventually rename mode files and going forward we should follow python filenaming standard

Comment on lines 1 to 5
Creating Your First Mode
========================

.. rst-class:: lead

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you verify that this mode actually works?

Its fine to do this in a next PR, just make sure these docs get updated if the code needs to be changed.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bumping to #385

@brianwei15
brianwei15 merged commit bd83f37 into main Sep 5, 2026
5 checks passed
@brianwei15
brianwei15 deleted the user/brianwei15/create-first-mode-tutorial branch September 5, 2026 18:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Write 'Modes, Missions, and the Mode Manager' concept Write 'Creating Your First Mode' Tutorial

2 participants