Skip to content

Improve model guide#515

Open
ElijahAhianyo wants to merge 11 commits intomasterfrom
elijah/model-docs-improve
Open

Improve model guide#515
ElijahAhianyo wants to merge 11 commits intomasterfrom
elijah/model-docs-improve

Conversation

@ElijahAhianyo
Copy link
Copy Markdown
Contributor

@ElijahAhianyo ElijahAhianyo commented Mar 20, 2026

Restructure the Docs, starting with the model docs. I've improved the docs to mention a large number of features/functionalities we support. I've also split the docs to span across multiple pages in a subcategory, making it easier and nicer to follow. Currently, we have 2 pages (overview and queries) for Models. The overview section is a bit nuanced as it makes mention of the CotORM, setting up models, and configuring them.

There's also a section of Relationships which I believe deserves its own page once we have the M2M feature implemented(or we can still put this in its own page and show how to do this using an intermediate through Model).

I would like to add another page for migrations, however, I'm keeping this PR ready at all times for review. Subsequent additions may or may not be included to this PR depending on when this gets merged

Related issue or discussion

Description

Type of change

  • Bug fix
  • New feature
  • Documentation
  • Refactor / cleanup
  • Performance improvement
  • Other (describe above)

Checklist

  • I've read the contributing guide
  • Tests pass locally (just test-all)
  • Code passes clippy (just clippy)
  • Code is properly formatted (cargo fmt)
  • New tests added (regression test for bugs, coverage for new features)
  • Documentation (both code and site) updated (if applicable)

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 20, 2026

🐰 Bencher Report

Branchelijah/model-docs-improve
Testbedgithub-ubuntu-latest
Click to view all benchmark results
BenchmarkLatencyBenchmark Result
milliseconds (ms)
(Result Δ%)
Upper Boundary
milliseconds (ms)
(Limit %)
empty_router/empty_router📈 view plot
🚷 view threshold
6.41 ms
(+5.68%)Baseline: 6.07 ms
7.37 ms
(87.04%)
json_api/json_api📈 view plot
🚷 view threshold
1.15 ms
(+9.04%)Baseline: 1.06 ms
1.26 ms
(91.71%)
nested_routers/nested_routers📈 view plot
🚷 view threshold
1.09 ms
(+11.77%)Baseline: 0.97 ms
1.15 ms
(94.82%)
single_root_route/single_root_route📈 view plot
🚷 view threshold
1.05 ms
(+11.92%)Baseline: 0.94 ms
1.11 ms
(94.14%)
single_root_route_burst/single_root_route_burst📈 view plot
🚷 view threshold
17.85 ms
(+0.99%)Baseline: 17.68 ms
21.08 ms
(84.68%)
🐰 View full continuous benchmarking report in Bencher

@codecov
Copy link
Copy Markdown

codecov bot commented Mar 20, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

Flag Coverage Δ
rust 89.99% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@github-actions github-actions bot added the A-docs Area: Documentation label Mar 31, 2026
@ElijahAhianyo
Copy link
Copy Markdown
Contributor Author

ElijahAhianyo commented Mar 31, 2026

depends on cot-rs/cot-site#82 and cot-rs/cot-site#84

@ElijahAhianyo
Copy link
Copy Markdown
Contributor Author

Screenshot 2026-04-02 at 3 51 59 PM


```

## Summary
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.

Some pages have a Summary section while others don't. I'm not too sure which direction we'd want to go, but for the sake of consistency, do we require every page to have a Summary section? I, personally, am not a big fan, but I'm also indifferent if we have them or not

@ElijahAhianyo ElijahAhianyo marked this pull request as ready for review April 9, 2026 17:19
@ElijahAhianyo ElijahAhianyo changed the title [WIP]Improve model guide Improve model guide Apr 9, 2026
@ElijahAhianyo ElijahAhianyo requested review from m4tx and seqre April 9, 2026 17:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-docs Area: Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant