Skip to content

docs: lead with {repos, #{...}} map form everywhere#115

Merged
Taure merged 1 commit into
mainfrom
docs/lead-with-repos-map
May 10, 2026
Merged

docs: lead with {repos, #{...}} map form everywhere#115
Taure merged 1 commit into
mainfrom
docs/lead-with-repos-map

Conversation

@Taure
Copy link
Copy Markdown
Owner

@Taure Taure commented May 10, 2026

Summary

Updates README, getting-started, MIGRATION-2.0, and kura_repo moduledoc to lead with the v2.0 {repos, #{...}} map-of-maps form for both single-repo and multi-repo configs.

The flat 1.x form ({repo, _}/{host, _}/{user, _}) still works but is now in a 'legacy / back-compat' section, not the primary example.

Why

The map form is the v2.0 idiom: single-repo today, forward-compatible if you add a second backend later. Showing the flat form as default signaled 'v1.x with extras' instead of the real v2.0 story.

Test plan

  • rebar3 fmt --check clean
  • rebar3 compile clean
  • No code changes (docs / moduledoc only)

The map-of-maps form is the v2.0 idiom. Updates README, getting-started,
MIGRATION-2.0, and kura_repo moduledoc to lead with it for both single-
and multi-repo configs. The flat 1.x form still works but moves to a
'legacy / back-compat' section.
@github-actions
Copy link
Copy Markdown

🟢 Code Coverage — 91.6%

2170 of 2368 lines covered.


✅ ELP Lint

No diagnostics.


ℹ️ 11 OTP CVEs auto-ignored (already fixed in running version)

These CVEs are patched in the installed OTP version but NVD data
has not been updated to reflect this. They are excluded from the
scan via an auto-generated .trivyignore.

CVE Details
CVE-2026-23943 Fixed in 28.4.1, running 28.4.1 — Pre-auth SSH DoS via unbounded zlib inflate
CVE-2026-23942 Fixed in 28.4.1, running 28.4.1 — SFTP root escape via component-agnostic prefix check in ssh_sftpd
CVE-2026-23941 Fixed in 28.4.1, running 28.4.1 — Request smuggling via first-wins Content-Length parsing in inets httpd
CVE-2026-21620 Fixed in 28.3.2, running 28.4.1 — TFTP Path Traversal
CVE-2016-1000107 Fixed in 28.0.4, running 28.4.1 — Httpd CGI Scripts Environment Variable Pollution AKA "httpoxy"
CVE-2025-58050 Fixed in 28.0.3, running 28.4.1 — Buffer Read Overflow on Regular Expressions with (*scs:) and (*ACCEPT)
CVE-2025-48038 Fixed in 28.0.3, running 28.4.1 — SSH Unverified File Handles can Cause Excessive Use of System Resources
CVE-2025-48039 Fixed in 28.0.3, running 28.4.1 — SSH Unverified Paths can Cause Excessive Use of System Resources
CVE-2025-48040 Fixed in 28.0.3, running 28.4.1 — SSH Malicious Key Exchange Messages may Lead to Excessive Resource Consumption
CVE-2025-48041 Fixed in 28.0.3, running 28.4.1 — SSH_FXP_OPENDIR may Lead to Exhaustion of File Handles
CVE-2025-4748 Fixed in 28.0.1, running 28.4.1 — Absolute Path in Zip Module

@Taure Taure merged commit a726bf6 into main May 10, 2026
16 checks passed
@Taure Taure deleted the docs/lead-with-repos-map branch May 10, 2026 18:54
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