Skip to content

refactor: rename example/ to service/#291

Open
sbalabanov wants to merge 1 commit into
mainfrom
service
Open

refactor: rename example/ to service/#291
sbalabanov wants to merge 1 commit into
mainfrom
service

Conversation

@sbalabanov

Copy link
Copy Markdown
Contributor

Summary

The example/ tree holds the runnable server/client wiring for every domain — it is the composition root (knows the full queue topology, picks concrete extension impls, owns per-queue routing), not throwaway demo code. This renames it to service/ to reflect that role.

Changes

  • git mv example/ → service/ (history preserved).
  • Updated every reference to the path: Bazel labels (//example/...), Go importpaths (.../example/...), Makefile compose vars + build-*-linux/run-client-* targets, docker-compose.yml build contexts, integration/e2e suite composeFile paths and their BUILD data entries, and docs (CLAUDE.md, README.md, doc/, submitqueue/orchestrator/controller/dlq/README.md).
  • Scoped replacements to actual path/label/importpath patterns — prose like "for example" and example.com fixtures were left untouched.

Documentation

  • Rewrote service/README.md for the current layout: adds the runway service (was missing) and corrects stovepipe from "Ping-only" to its real Ping + Ingest + process-consumer shape; services table with ports/RPCs/stores.
  • Added service/runway/README.md and service/stovepipe/README.md.
  • Retitled service/submitqueue/README.md heading.

Validation

  • make test — 65/65 pass
  • bazel build //service/... (16 targets) and //test/... (12 targets) pass
  • make gazelle clean (alphabetical reorder of one data list); gofmt clean

🤖 Generated with Claude Code

@sbalabanov sbalabanov requested review from a team and behinddwalls as code owners June 30, 2026 21:20
@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

The example/ tree holds the runnable server/client wiring for every
domain — it is the composition root, not throwaway demo code. Rename it
to service/ to reflect that role and update all references: Bazel labels,
Go importpaths, Makefile compose vars and targets, docker-compose build
contexts, integration/e2e suite paths, and documentation.

Also refresh the docs for the current layout:
- Rewrite service/README.md to include the runway service and the
  stovepipe Ingest/process pipeline (previously documented as Ping-only).
- Add service/runway/README.md and service/stovepipe/README.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.

4 participants