Skip to content

Conversation

@timbrinded
Copy link
Collaborator

This pull request updates the documentation to provide a clearer, more comprehensive overview of the TQ Oracle architecture and usage. The changes focus on improving explanations of the core pipeline, expanding details on Mellow Vaults and the oracle lifecycle, and restructuring configuration and usage instructions for clarity.

Copilot AI review requested due to automatic review settings December 4, 2025 13:13
@timbrinded timbrinded added the documentation Improvements or additions to documentation label Dec 4, 2025
Copilot finished reviewing on behalf of timbrinded December 4, 2025 13:15
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR refactors the documentation to improve clarity and organization by moving detailed configuration and architecture information into dedicated files (SETTINGS.md and ARCHITECTURE.md) and consolidating the README to focus on quick-start usage. The changes add comprehensive documentation about Mellow Vaults integration, including visual diagrams explaining deposit/redeem flows and the oracle lifecycle.

Key changes:

  • Relocated detailed configuration tables from README.md to SETTINGS.md, replacing with a reference link
  • Added extensive Mellow Vaults architecture documentation including three Mermaid diagrams showing vault structure, deposit flow, and redeem flow
  • Updated all CLI command examples to use uv run prefix consistently

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
README.md Streamlined by removing detailed configuration tables and development sections, replacing them with references to SETTINGS.md and ARCHITECTURE.md; updated all command examples to use uv run prefix
ARCHITECTURE.md Enhanced with new "How Mellow Vaults Work" section containing Mermaid diagrams, detailed explanations of vault components, deposit/redeem lifecycle, and oracle report lifecycle

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@timbrinded timbrinded marked this pull request as ready for review December 4, 2025 13:19
Copilot AI review requested due to automatic review settings December 4, 2025 13:19
@timbrinded timbrinded merged commit 3364779 into master Dec 4, 2025
10 checks passed
@timbrinded timbrinded deleted the docs/update-readme branch December 4, 2025 13:19
Copilot finished reviewing on behalf of timbrinded December 4, 2025 13:21
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants