Skip to content

docs: document TUI, password-based encryption, and S3/database VFS backends#22

Merged
tgiachi merged 1 commit into
developfrom
docs/session-features
Jun 30, 2026
Merged

docs: document TUI, password-based encryption, and S3/database VFS backends#22
tgiachi merged 1 commit into
developfrom
docs/session-features

Conversation

@tgiachi

@tgiachi tgiachi commented Jun 30, 2026

Copy link
Copy Markdown
Owner

Summary

Brings the site-level documentation in line with features merged this cycle (the per-module READMEs were already current; this updates the root index, the DocFX articles, and the tutorials).

Root README — Packages table

  • Added a User interface section with SquidStd.Tui (was entirely absent).
  • Added SquidStd.Vfs.S3 and SquidStd.Vfs.Database rows.
  • Updated SquidStd.Vfs (now mentions the read-only/scoped/overlay/caching decorators) and SquidStd.Crypto (now mentions PasswordCipher / Argon2id + AES-256-GCM) descriptions.

DocFX articles

  • New include pages tui.md, vfs-s3.md, vfs-database.md (reference-include of their READMEs) + articles/toc.yml entries. (crypto.md/vfs.md articles already reflect the updates via the include pattern.)

DocFX tutorials

  • New Terminal UI (MVVM) tutorial (Counter example, imperative TuiView<T> + declarative TuiComposedView<T> DSL, DI boot, navigation).
  • Updated the Virtual filesystem tutorial (S3 + database backends, composable decorators incl. offline-resilient caching) and the Crypto tutorial (password-based encryption section).

Notes

  • No src/**/README.md or docs/api/** changes.
  • docfx build ran clean (0 errors; the 4 warnings are pre-existing — relative cross-links in source READMEs + the known api/toc.yml note).

Test plan

  • docfx build docs/docfx.json — 0 errors
  • All new article include paths + toc hrefs resolve to existing files
  • Tutorial code cross-checked against the real module APIs (one wrong named arg in the Overlay snippet fixed)

…S backends

- README: add SquidStd.Tui row under new ### User interface section (after Workers)
- README: update SquidStd.Vfs row to mention composable decorators (ReadOnlyFileSystem,
  ScopedFileSystem, OverlayFileSystem, CachingFileSystem)
- README: add SquidStd.Vfs.S3 and SquidStd.Vfs.Database rows to Storage section
- README: update SquidStd.Crypto row to mention PasswordCipher and Argon2id + AES-256-GCM
- README: extend Overview bullet for Data & storage to mention new VFS backends/decorators;
  add new Terminal UI bullet for SquidStd.Tui
- docs/articles: add tui.md, vfs-s3.md, vfs-database.md include articles
- docs/articles/toc.yml: add SquidStd.Vfs.S3, SquidStd.Vfs.Database after SquidStd.Vfs;
  add SquidStd.Tui before SquidStd.Crypto
- docs/tutorials/tui.md: new tutorial covering CounterViewModel, imperative TuiView<T>,
  declarative TuiComposedView<T> DSL, DI boot, and ViewModel-first navigation
- docs/tutorials/vfs.md: add S3 and database backend sections; add CachingFileSystem,
  ReadOnlyFileSystem, ScopedFileSystem, and OverlayFileSystem decorator examples
- docs/tutorials/crypto.md: add password-based encryption section (PasswordCipher.Encrypt/
  Decrypt, EncryptString/DecryptString, PbkdfCost.Sensitive, PasswordDecryptionException)
- docs/tutorials/toc.yml: add Terminal UI (MVVM) entry
@tgiachi
tgiachi merged commit 09908ff into develop Jun 30, 2026
3 checks passed
@tgiachi
tgiachi deleted the docs/session-features branch June 30, 2026 16:38
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.

1 participant