Skip to content

docs: bootstrap MkDocs Material site with Features and Architecture - #52

Merged
Insei merged 1 commit into
mainfrom
docs
Apr 18, 2026
Merged

docs: bootstrap MkDocs Material site with Features and Architecture#52
Insei merged 1 commit into
mainfrom
docs

Conversation

@Insei

@Insei Insei commented Apr 18, 2026

Copy link
Copy Markdown
Owner

Introduces a full documentation site published to GitHub Pages.

  • docs/index.md: quick-start landing with install, a runnable snippet, navigation cards, and the adapter matrix.
  • docs/features/ (15 pages): covers every public capability — builder, columns, CRUD, WHERE operators, ordering & pagination, exclude/only, persistent queries, soft delete, virtual columns, hooks, transactions, cache, error transformer, adapters.
  • docs/architecture/ (8 pages): for contributors — ideology, layered request flow, sqlstmt/sqlpart internals, fmap-based field mapping, CtxCache internals, adapter anatomy, and a contributing guide.
  • mkdocs.yml: Material theme, light/dark palette, tabbed navigation, code copy/annotations, superfences, admonitions.
  • .github/workflows/docs.yml: builds with --strict on push to main (paths-filtered to docs/**, mkdocs.yml) and deploys via actions/deploy-pages. Pages source must be set to "GitHub Actions".

  Introduces a full documentation site published to GitHub Pages.

  - docs/index.md: quick-start landing with install, a runnable snippet,
    navigation cards, and the adapter matrix.
  - docs/features/ (15 pages): covers every public capability — builder,
    columns, CRUD, WHERE operators, ordering & pagination, exclude/only,
    persistent queries, soft delete, virtual columns, hooks, transactions,
    cache, error transformer, adapters.
  - docs/architecture/ (8 pages): for contributors — ideology, layered
    request flow, sqlstmt/sqlpart internals, fmap-based field mapping,
    CtxCache internals, adapter anatomy, and a contributing guide.
  - mkdocs.yml: Material theme, light/dark palette, tabbed navigation,
    code copy/annotations, superfences, admonitions.
  - .github/workflows/docs.yml: builds with --strict on push to main
    (paths-filtered to docs/**, mkdocs.yml) and deploys via
    actions/deploy-pages. Pages source must be set to "GitHub Actions".
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 61.17%. Comparing base (9fb2208) to head (e2e1dd0).

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #52   +/-   ##
=======================================
  Coverage   61.17%   61.17%           
=======================================
  Files          54       54           
  Lines        1955     1955           
=======================================
  Hits         1196     1196           
  Misses        710      710           
  Partials       49       49           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

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

@Insei
Insei merged commit c280449 into main Apr 18, 2026
6 checks passed
@Insei
Insei deleted the docs branch April 18, 2026 23:22
@github-actions

Copy link
Copy Markdown

Benchmark diff: c2804495a52180 (mockdb, 10 runs)

goos: linux
goarch: amd64
pkg: github.com/insei/gerpo/tests
cpu: Intel(R) Xeon(R) Platinum 8370C CPU @ 2.80GHz
                  │  base.txt   │              head.txt              │
                  │   sec/op    │   sec/op     vs base               │
GetFirst_Direct-4   130.3n ± 1%   131.1n ± 2%       ~ (p=0.158 n=10)
GetFirst_Gerpo-4    1.106µ ± 0%   1.114µ ± 0%  +0.72% (p=0.000 n=10)
GetList_Direct-4    743.6n ± 0%   747.2n ± 0%  +0.49% (p=0.001 n=10)
GetList_Gerpo-4     2.744µ ± 0%   2.754µ ± 0%  +0.38% (p=0.041 n=10)
Count_Direct-4      75.69n ± 0%   75.91n ± 0%  +0.30% (p=0.017 n=10)
Count_Gerpo-4       660.5n ± 0%   661.3n ± 0%       ~ (p=0.271 n=10)
Insert_Direct-4     112.4n ± 1%   111.2n ± 0%  -1.07% (p=0.049 n=10)
Insert_Gerpo-4      600.9n ± 1%   601.9n ± 0%       ~ (p=0.516 n=10)
Update_Direct-4     55.49n ± 0%   55.46n ± 0%       ~ (p=0.541 n=10)
Update_Gerpo-4      1.157µ ± 0%   1.159µ ± 0%       ~ (p=0.188 n=10)
Delete_Direct-4     53.06n ± 0%   53.07n ± 0%       ~ (p=0.985 n=10)
Delete_Gerpo-4      721.8n ± 0%   722.4n ± 0%       ~ (p=0.541 n=10)
geomean             340.6n        341.2n       +0.16%

                  │   base.txt   │               head.txt                │
                  │     B/op     │     B/op      vs base                 │
GetFirst_Direct-4     216.0 ± 0%     216.0 ± 0%       ~ (p=1.000 n=10) ¹
GetFirst_Gerpo-4      848.0 ± 0%     848.0 ± 0%       ~ (p=1.000 n=10) ¹
GetList_Direct-4    1.586Ki ± 0%   1.586Ki ± 0%       ~ (p=1.000 n=10) ¹
GetList_Gerpo-4     2.289Ki ± 0%   2.289Ki ± 0%       ~ (p=1.000 n=10) ¹
Count_Direct-4        64.00 ± 0%     64.00 ± 0%       ~ (p=1.000 n=10) ¹
Count_Gerpo-4         368.0 ± 0%     368.0 ± 0%       ~ (p=1.000 n=10) ¹
Insert_Direct-4       112.0 ± 0%     112.0 ± 0%       ~ (p=1.000 n=10) ¹
Insert_Gerpo-4        552.0 ± 0%     552.0 ± 0%       ~ (p=1.000 n=10) ¹
Update_Direct-4       56.00 ± 0%     56.00 ± 0%       ~ (p=1.000 n=10) ¹
Update_Gerpo-4        944.0 ± 0%     944.0 ± 0%       ~ (p=1.000 n=10) ¹
Delete_Direct-4       40.00 ± 0%     40.00 ± 0%       ~ (p=1.000 n=10) ¹
Delete_Gerpo-4        608.0 ± 0%     608.0 ± 0%       ~ (p=1.000 n=10) ¹
geomean               323.3          323.3       +0.00%
¹ all samples are equal

                  │  base.txt  │              head.txt               │
                  │ allocs/op  │ allocs/op   vs base                 │
GetFirst_Direct-4   5.000 ± 0%   5.000 ± 0%       ~ (p=1.000 n=10) ¹
GetFirst_Gerpo-4    17.00 ± 0%   17.00 ± 0%       ~ (p=1.000 n=10) ¹
GetList_Direct-4    21.00 ± 0%   21.00 ± 0%       ~ (p=1.000 n=10) ¹
GetList_Gerpo-4     34.00 ± 0%   34.00 ± 0%       ~ (p=1.000 n=10) ¹
Count_Direct-4      4.000 ± 0%   4.000 ± 0%       ~ (p=1.000 n=10) ¹
Count_Gerpo-4       10.00 ± 0%   10.00 ± 0%       ~ (p=1.000 n=10) ¹
Insert_Direct-4     5.000 ± 0%   5.000 ± 0%       ~ (p=1.000 n=10) ¹
Insert_Gerpo-4      14.00 ± 0%   14.00 ± 0%       ~ (p=1.000 n=10) ¹
Update_Direct-4     3.000 ± 0%   3.000 ± 0%       ~ (p=1.000 n=10) ¹
Update_Gerpo-4      23.00 ± 0%   23.00 ± 0%       ~ (p=1.000 n=10) ¹
Delete_Direct-4     3.000 ± 0%   3.000 ± 0%       ~ (p=1.000 n=10) ¹
Delete_Gerpo-4      17.00 ± 0%   17.00 ± 0%       ~ (p=1.000 n=10) ¹
geomean             9.581        9.581       +0.00%
¹ all samples are equal

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