docs(agents): old code moves into its module; a rewrite or a deletion needs a verdict in the move map (#1977)
This commit is contained in:
1 file changed
+9
-4
@@ -24,13 +24,18 @@ there:
|
||||
nothing outside the module can import. Modules reach each other only through
|
||||
API packages, own their schema and tables, and keep no state only in memory.
|
||||
- `internal/platform/` holds the few leaf packages every module may use.
|
||||
- The new code never imports the old services' packages (depguard enforces it);
|
||||
move what you need instead.
|
||||
- The new code never imports the old services' packages (depguard enforces it).
|
||||
Old code moves: `git mv` it into the module that owns it, then adapt it.
|
||||
MIGRATION.md in sam/archie-product gives every old package a destination and
|
||||
a verdict. Writing a replacement from scratch, or deleting an old package,
|
||||
needs the maintainer's verdict on its row. Before building anything an old
|
||||
package already does, read that package and carry its behaviour.
|
||||
|
||||
### The services being replaced
|
||||
|
||||
The six services below are deleted slice by slice as the binary replaces them.
|
||||
Don't add features to them; fix them only when a bug blocks work.
|
||||
The six services below are deleted slice by slice as the binary replaces them,
|
||||
each only once MIGRATION.md has a verdict for every package it holds. Don't
|
||||
add features to them; fix them only when a bug blocks work.
|
||||
|
||||
Each service is a gRPC contract in `proto/<service>/v1`, generated into
|
||||
`internal/contracts/<service>/v1`, and one binary in `cmd/` that parses flags
|
||||
|
||||
Reference in new issue
Block a user