bretton.dev
A community based topic aggregation platform built on atproto
docs: update PRD to reflect .community. handle format
Update Product Requirements Document to document the singular
.community. naming convention.
Changes:
- Update handle format examples
- Document identifier resolution features
- Update API examples with new handle format
This ensures documentation matches the implemented handle format
and provides clear examples for developers.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
+4
-4
docs/PRD_COMMUNITIES.md
+4
-4
docs/PRD_COMMUNITIES.md
···
257
257
- [ ] **Security Checklist:** Pre-launch security audit
258
258
259
259
### Infrastructure & DNS
260
-
- [ ] **DNS Wildcard Setup:** Configure `*.communities.coves.social` for community handle resolution
261
-
- [ ] **Well-Known Endpoint:** Implement `.well-known/atproto-did` handler for `*.communities.coves.social` subdomains
260
+
- [ ] **DNS Wildcard Setup:** Configure `*.community.coves.social` for community handle resolution
261
+
- [ ] **Well-Known Endpoint:** Implement `.well-known/atproto-did` handler for `*.community.coves.social` subdomains
262
262
263
263
---
264
264
···
310
310
**Status:** ✅ Implemented and tested
311
311
312
312
**Required Fields:**
313
-
- `handle` - atProto handle (DNS-resolvable, e.g., `gaming.communities.coves.social`)
313
+
- `handle` - atProto handle (DNS-resolvable, e.g., `gaming.community.coves.social`)
314
314
- `name` - Short community name for !mentions (e.g., `gaming`)
315
315
- `createdBy` - DID of user who created community
316
316
- `hostedBy` - DID of hosting instance
···
378
378
- Follows separation of concerns: protocol layer uses DNS handles, UI layer formats for display
379
379
380
380
**Implementation:**
381
-
- Lexicon: `handle` = `gaming.communities.coves.social` (DNS-resolvable)
381
+
- Lexicon: `handle` = `gaming.community.coves.social` (DNS-resolvable)
382
382
- Client derives display: `!${name}@${instance}` from `name` + parsed instance
383
383
- Rich text facets can encode community mentions with `!` prefix for UX
384
384