docs: Erlang quick start + phases/seasons/matchmaker-strategies + glossary#41
Open
docs: Erlang quick start + phases/seasons/matchmaker-strategies + glossary#41
Conversation
New page + sidebar entry under Get started, linked from the docs overview card grid. Clears up "asobi vs asobi_lua vs asobi.dev Cloud" confusion at first contact. Also swaps the quickstart Lua deploy step from 'asobi-cli deploy' to a docker-compose volume mount, since the CLI depends on the managed cloud which isn't public yet.
New /docs/erlang/getting-started, sidebar entry under Erlang reference, card on docs overview. Walks from rebar3 new app through asobi_match behaviour, sys.config wiring, rebar3 shell boot, wscat verification, and code:load_file/1 hot reload in one page. Closes the Erlang-path credibility gap surfaced by the 2026-04-23 DevEx audit: before, Erlang devs were sent to the bilingual tic-tac-toe tutorial with no standalone entry point.
Three pages surfacing previously-invisible gameplay systems: - /docs/phases — phase engine + the four timer primitives (countdown, conditional, cycle, scheduled), Erlang + Lua examples. - /docs/seasons — season lifecycle, config, queries. Notes that game.season from Lua isn't wired yet. - /docs/erlang/matchmaker-strategies — the asobi_matchmaker_strategy behaviour contract plus a worked party-aware example. Sidebar additions: - Gameplay systems: Phases & timers, Seasons - Erlang reference: Matchmaker strategies Closes audit items #2 (phases/timers/seasons under-documented), #7 (custom matchmaker strategies undocumented), and #8 (seasons mentioned in README without a reference page).
- Adds a callout linking to examples/erlang-match/ as the no-scaffold path (git clone && rebar3 shell). - Updates register curl password from hunter2 (7 chars, fails 422) to hunter-2026 so the snippet actually works against nova_auth's minimum-length validation.
🟡 ELP Lint — 3 warnings4 diagnostics found. See job logs for details. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Five new pages closing Erlang-path credibility and hidden-feature gaps from the 2026-04-23 DevEx audit:
/docs/glossary— asobi vs asobi_lua vs asobi.dev Cloud, plus concept vocabulary. Linked from the docs overview card grid and sidebar./docs/erlang/getting-started— dedicated 20-minute Erlang quick start. rebar3 new app → asobi_match → sys.config → rebar3 shell → wscat →code:load_file/1hot reload. Links to the companionexamples/erlang-match/project./docs/phases— phase engine + four timer primitives (countdown, conditional, cycle, scheduled), Erlang + Lua side-by-side with theon_phase_started/on_phase_endedcallbacks./docs/seasons— lifecycle, query API, honest note that the Lua bridge isn't wired yet./docs/erlang/matchmaker-strategies—asobi_matchmaker_strategybehaviour contract + worked party-aware example.Also:
asobi-cli deployto a docker-compose volume mount (CLI depends on managed cloud which isn't public yet).Closes audit items #1, #2, #5, #6, #7, #8.
Test plan
rebar3 compile && rebar3 fmt --check && rebar3 xref && rebar3 dialyzer && rebar3 ctall green