You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit db548b3
Browse filesBrowse the repository at this point in the historyBrowse files
docs(plans): drop "What was checked" and "Needs" from the walkthroughs
Each walkthrough repeated rows of the index's "What was checked" table,
and nothing kept the copies in step with it. The opening line of each
page still links the index, which holds the one table.
A "Needs" line mostly pointed back at the section before it, which the
order of the page already shows. Also stop saying "carries" in prose.
Claude-Session: https://claude.ai/code/session_016Usf7cQGY6ULWGyZ4NHQEB
Copy file name to clipboardExpand all lines: docs/plans/2026-10-04-plan-builder/contacts/README.md
-28Lines changed: 0 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,6 @@ It shows what `stashgen` is planned to write.
21
21
22
22
-**Purpose:** Connect a tag declaration in your own package to `crm.Contact`.
23
23
-**Related:**[The `crm.Contact` type in another package](../crm/README.md), [the plan's design for types in another package](../../2026-10-04-plan-builder.md#types-in-another-package)
24
-
-**Needs:** Understand that the program does not own `crm.Contact`.
25
24
26
25
The `-for crm.Contact` flag makes `contactStash` declare tags for a type in another package.
27
26
The generator is planned to match fields by name and type.
@@ -72,7 +71,6 @@ type contactShape struct {
72
71
73
72
-**Purpose:** See how each encrypted field holds a ciphertext and its declared search terms.
Copy file name to clipboardExpand all lines: docs/plans/2026-10-04-plan-builder/crm/README.md
-12Lines changed: 0 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,6 @@ The [Go example index](../README.md) lists every example and what was checked.
17
17
18
18
-**Purpose:** Understand why `crm.Contact` stays free of encryption tags.
19
19
-**Related:**[The plan's design for types in another package](../../2026-10-04-plan-builder.md#types-in-another-package), [the contacts walkthrough](../contacts/README.md)
20
-
-**Needs:** Nothing
21
20
22
21
`crm.Contact` contains only the fields supplied by the stand-in package.
23
22
@@ -54,7 +53,6 @@ type contactStash struct {
54
53
55
54
-**Purpose:** See how a change to `crm.Contact` stops the contacts package from building.
56
55
-**Related:**[The contacts walkthrough](../contacts/README.md), [the plan's design for types in another package](../../2026-10-04-plan-builder.md#types-in-another-package)
57
-
-**Needs:** Understand the fields of `crm.Contact`.
58
56
59
57
The generated file converts `crm.Contact` to `contactShape` at compile time.
60
58
The conversion fails when `crm.Contact` gains, loses, reorders, or retypes a field.
@@ -72,13 +70,3 @@ type contactShape struct {
72
70
Internalstring
73
71
}
74
72
```
75
-
76
-
## What was checked
77
-
78
-
-**Every Go file type-checks:**
79
-
Run.
80
-
`go vet ./...` passes against a stub of the SDK.
81
-
The stub is not in this repository, and it has signatures only.
82
-
-**A change to a tagged struct, a model or a type in another package stops the build:**
83
-
Run.
84
-
Each change fails `go build` with "cannot convert".
`Name` has one ciphertext, while `Email` has a ciphertext and two search terms.
@@ -66,7 +65,6 @@ var declaration = gensupport.Declare("individuals").
66
65
67
66
-**Purpose:** Understand why protobuf messages do not use the usual shape check.
68
67
-**Related:**[The generated protobuf walkthrough](../internal/pb/README.md), [the plan's design for types in another package](../../2026-10-04-plan-builder.md#types-in-another-package)
69
-
-**Needs:** Know that `pb.Individual` contains unexported protobuf fields.
70
68
71
69
The codec takes `*pb.Individual` values.
72
70
It reads each field through a generated getter because direct struct conversion cannot include unexported fields.
@@ -102,7 +100,6 @@ CI runs `go generate ./...` and fails when a generated file differs from the com
102
100
103
101
- **Purpose:** Follow protobuf pointers and the Medicare field through the generated API.
buf v1.50.0 ran `protoc-gen-go` v1.26.0 to write these files.
22
21
The generated header reports the `protoc` version as unknown.
@@ -42,7 +41,6 @@ package pb
42
41
43
42
-**Purpose:** Identify the generated values that the individuals example reads.
44
43
-**Related:**[The generated individuals walkthrough](../../individuals/README.md), [the plan's design for types in another package](../../../2026-10-04-plan-builder.md#types-in-another-package)
45
-
-**Needs:** Understand the `Individual` message fields.
46
44
47
45
`pb.Individual` includes three unexported protobuf fields before its exported data fields.
48
46
@@ -89,7 +87,6 @@ The examples do not use protobuf internals such as `file_individual_proto_rawDes
89
87
90
88
-**Purpose:** Connect the protobuf option to the planned policy source.
0 commit comments