Skip to content

docs: improve README structure and add conceptual overview - #362

Merged
Eomm merged 1 commit into
mainfrom
docs/improve-readme
Sep 1, 2026
Merged

docs: improve README structure and add conceptual overview#362
Eomm merged 1 commit into
mainfrom
docs/improve-readme

Conversation

@Tony133

@Tony133 Tony133 commented Aug 25, 2026

Copy link
Copy Markdown
Member

Proposal:

  • Restructures the README to make it easier to understand how Avvio works, not just how to call its API.

Changes:

  • Added a "How Avvio works" section explaining the plugin tree, load order, and boot lifecycle before the API reference
  • Added ASCII diagrams for the plugin tree, boot lifecycle, and error handling flow
  • Clarified the distinct roles of use(), after(), and ready()
  • Added a table of error codes (AVV_ERR_*) with descriptions
  • Reorganized the API reference with a table of contents

Closes issue: #24

@Tony133
Tony133 force-pushed the docs/improve-readme branch from 58ef865 to 37fc7cb Compare August 25, 2026 20:21
- Add 'How Avvio works' section explaining the plugin tree, load order and boot lifecycle
- Add ASCII diagrams for plugin tree, boot lifecycle and error flow
- Clarify differences between use(), after() and ready()
- Add error codes table with descriptions
- Reorganize API reference for easier navigation
@Tony133
Tony133 force-pushed the docs/improve-readme branch from 37fc7cb to 2274a7b Compare August 25, 2026 20:22
@Tony133
Tony133 marked this pull request as ready for review August 25, 2026 21:30
@Tony133
Tony133 requested a review from mcollina August 25, 2026 21:33
@Eomm
Eomm merged commit 52f5cbb into main Sep 1, 2026
3 checks passed
@Eomm
Eomm deleted the docs/improve-readme branch September 1, 2026 11:55
@Tony133 Tony133 mentioned this pull request Sep 1, 2026
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.

2 participants