Skip to content

Conversation

c1570
Copy link

@c1570 c1570 commented Oct 4, 2025

Describe the PR
This streamlines documentation quite a bit:

  • first and foremost, this improves "getting started" in many regards.
    • improving text flow (starts with examples rather than setup details)
    • simplifies the example code to a common case rather than the corner tud+tuh case
    • streamlines details that don't really belong in a getting started document, like IAR
    • improves and rearranges headlines so that the TOC becomes more useful
    • links to source where appropriate
  • this adds a couple of pages
    • architecture overview
    • glossary
    • FAQ
    • troubleshooting

Additional context
Note that an LLM has been used for creating this; there has been quite a lot of manual review work of course (I'm a rather new user of TinyUSB though so please check).

I leave this as a Draft for now; I'm down for investing more work into this but want to make sure first that there's general interest @hathach


**Optional Functions**:
- ``close()``: Clean up class resources
- ``sof_cb()``: Start-of-frame processing
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- ``sof_cb()``: Start-of-frame processing
- ``sof()``: Start-of-frame processing

- ``control_xfer_cb()``: Handle control requests
- ``xfer_cb()``: Handle data transfer completion

**Optional Functions**:
Copy link
Contributor

Choose a reason for hiding this comment

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

xfer_isr that was added in 0.19.0 is missing

Copy link
Owner

@hathach hathach left a comment

Choose a reason for hiding this comment

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

brilliant, I would also use LLM to generate majority of documents and do manual touch-up as well. For quick glance, this is indeed greatly improve the documentation. Please keep up your good works, we will merge this for sure.

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.

3 participants