Skip to content

Commit 893cb8a

Browse files
bakerboy448claude
andcommitted
docs: update README with latest transparency improvements
- Updated sample wiki output to show actual removal reasons - Enhanced database schema documentation with transparency details - Updated features to highlight complete removal reason transparency - Shows AutoModerator rule text and addremovalreason descriptions - Documents unique content ID tracking improvements 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 1769052 commit 893cb8a

1 file changed

Lines changed: 14 additions & 5 deletions

File tree

README.md

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Automatically publishes Reddit moderation logs to a subreddit wiki page with mod
1313
* 🧩 Fully CLI-configurable (no need to edit `config.json`)
1414
* 📁 Per-subreddit log files for debugging and monitoring
1515
* 🔒 Configurable moderator anonymization (AutoModerator/HumanModerator)
16-
* 📝 **Full removal reason transparency** - shows actual text, template numbers, all available data
16+
* 📝 **Complete removal reason transparency** - AutoModerator rule text, addremovalreason descriptions, all actual removal text (never generic messages or template numbers)
1717
* 🔗 Links directly to actual content (posts/comments), never user profiles for privacy
1818
* 🆔 **Unique content IDs** - comments show comment IDs, posts show post IDs for precise tracking
1919
***Multi-subreddit database support** - single database handles multiple subreddits safely
@@ -111,12 +111,13 @@ The database will automatically migrate to the latest schema version on startup.
111111
Sample wiki table output:
112112

113113
```markdown
114-
## 2025-08-08
114+
## 2025-08-09
115115

116116
| Time | Action | ID | Moderator | Content | Reason | Inquire |
117117
|------|--------|----|-----------|---------|--------|---------|
118-
| 23:19:35 UTC | removecomment | 1mkz4jm | AutoModerator | [Comment by u/potherb85](https://www.reddit.com/r/usenet/comments/1mkz4jm/usenet_in_china/n7otf1f/) | Filter - Possible Non Usenet related [proxy], review/approve manually | [Contact Mods](https://www.reddit.com/message/compose?to=/r/usenet&subject=Comment%20Removal%20Inquiry%20-%20Content%20by%20u/potherb85...) |
119-
| 22:33:36 UTC | addremovalreason | 1mkyw13 | HumanModerator | [How can I verify if NewsLazer is actually using SSL?](https://www.reddit.com/r/usenet/comments/1mkyw13/how_can_i_verify_if_newslazer_is_actually_using/) | No Discussions About Usenet Automation Software | [Contact Mods](https://www.reddit.com/message/compose?to=/r/usenet&subject=Removal%20Reason...) |
118+
| 08:15:42 UTC | removecomment | n7ravg2 | AutoModerator | [Comment by u/user123](https://www.reddit.com/r/opensignups/comments/1ab2cd3/title/n7ravg2/) | Possibly requesting an invite - [invited] Offers must be [O] 3x Invites to MyAwesomeTracker | [Contact Mods](https://www.reddit.com/message/compose?to=/r/opensignups&subject=Comment%20Removal%20Inquiry...) |
119+
| 07:45:18 UTC | addremovalreason | 1ab2cd3 | Bakerboy448 | [Post title here](https://www.reddit.com/r/opensignups/comments/1ab2cd3/title/) | Invites - No asking | [Contact Mods](https://www.reddit.com/message/compose?to=/r/opensignups&subject=Removal%20Reason%20Inquiry...) |
120+
| 06:32:15 UTC | removelink | 1xy9def | AutoModerator | [Another post](https://www.reddit.com/r/opensignups/comments/1xy9def/another/) | No standalone URL in post body | [Contact Mods](https://www.reddit.com/message/compose?to=/r/opensignups&subject=Post%20Removal%20Inquiry...) |
120121
```
121122

122123
## Logging
@@ -205,7 +206,15 @@ sqlite3 modlog.db "DELETE FROM processed_actions WHERE created_at < date('now',
205206
206207
### Database Schema
207208
208-
The database now includes a `removal_reason` column that stores the reason/details from Reddit's API for each moderation action.
209+
The database includes comprehensive moderation data with full transparency:
210+
211+
- **`removal_reason` column**: Stores actual removal reason text from Reddit's API
212+
- AutoModerator actions: Full rule text (e.g., "Possibly requesting an invite - [invited] Offers must be [O]")
213+
- addremovalreason actions: Readable removal reason (e.g., "Invites - No asking") instead of template numbers
214+
- Manual removals: Moderator-provided text or rule details
215+
- **`target_author` column**: Actual usernames of content authors (never shows [deleted])
216+
- **`subreddit` column**: Multi-subreddit support with proper data separation
217+
- **Unique content IDs**: Comments show comment IDs (e.g., n7ravg2), posts show post IDs
209218
210219
## Systemd Service (Optional)
211220

0 commit comments

Comments
 (0)