docs: define sensitivity and protection method#151
Conversation
Greptile SummaryThis PR adds a new "Key concepts" section to
Confidence Score: 5/5Documentation-only change; no code paths are modified. The change touches only a Markdown documentation file, adding two reference tables that are consistent with the leakage weights and enum values already present elsewhere in the document and codebase. There is no runtime risk. No files require special attention. Important Files Changed
Flowchart%%{init: {'theme': 'neutral'}}%%
flowchart TD
A[Entity detected] --> B[Assign Sensitivity]
B --> C{Sensitivity level}
C -->|high - weight 1.0| D["Direct identifiers\n(names, IDs, contacts)"]
C -->|medium - weight 0.6| E["Quasi-identifiers\n(location, occupation, age)"]
C -->|low - weight 0.3| F["Generic attributes\n(widely shared traits)"]
D & E & F --> G[Assign Protection Method]
G --> H{Method chosen}
H --> I[replace\nSynthetic alternative]
H --> J[generalize\nBroader category]
H --> K[suppress_inference\nRewrite surrounding text]
H --> L[remove\nDelete entirely]
H --> M[leave_as_is\nNo change needed]
I & J & K & L --> N[Leakage scoring]
M --> O{strict_entity_protection?}
O -->|True| P[Override → active protection]
O -->|False| N
P --> N
Reviews (6): Last reviewed commit: "Update docs/concepts/rewrite.md" | Re-trigger Greptile |
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
lipikaramaswamy
left a comment
There was a problem hiding this comment.
looks good, provides more clarity on the total risk management approach we describe in the devnote.
Co-authored-by: lipikaramaswamy <31832945+lipikaramaswamy@users.noreply.github.com>
* feature: add docs for sensitivity and protection method * fix: address review feedback on sensitivity * fix: undoing change I made to wrong PR * Update docs/concepts/rewrite.md Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> * fix: add more detail and organization to definitions * Update docs/concepts/rewrite.md Co-authored-by: lipikaramaswamy <31832945+lipikaramaswamy@users.noreply.github.com> --------- Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> Co-authored-by: lipikaramaswamy <31832945+lipikaramaswamy@users.noreply.github.com>
Changes include: