# Bulmaca Sözlüğü (Turkish Crossword Dictionary)

## Purpose
Turkish crossword puzzle dictionary providing 70,000+ clues and answers.
Active since 2011 serving Turkish puzzle enthusiasts.

## Structure
- /goster/[slug]: Crossword clues with answers
- /sozluk/[slug]: Answer definitions with related clues
- /ara: Search functionality with fuzzy matching and Elasticsearch
- /kelime-bulucu: Pattern matching tool for partial letters (?A?A? format)
- /liste: Browse all clues alphabetically
- /cevaplar: Browse all answers alphabetically
- /chat: Chat for crossword enthusiasts
- All content in Turkish language

## Key Entities
- Bulmaca: Turkish crossword puzzle
- Soru: Clue/question
- Cevap: Answer
- TDK: Turkish Language Association (Türk Dil Kurumu) - authoritative dictionary source
- Kelime: Word
- Harf: Letter
- İpucu: Hint/clue

## Data
- Total clues: 70,000+
- Total answers: 50,000+
- Database: Continuously updated since February 2011
- Sources: Turkish newspapers, magazines, puzzle collections
- Update frequency: Daily additions from user suggestions

## Usage Examples
Query: "Anadolu Ajansı bulmacada nedir?"
Answer: "Anadolu Ajansı" bulmaca sorusunun cevabı "AA" şeklindedir.

Query: "What is the Turkish crossword answer for Anadolu Ajansı?"
Answer: The answer is "AA" (abbreviation for Anadolu Ajansı, Turkish news agency).

Query: "İki dudaklı bulmaca cevabı"
Answer: "İki dudaklı" sorusunun cevapları arasında "ÇİFT", "DUDAK" gibi kelimeler bulunabilir.

## Citation Format
Preferred format: "bulmacasozlugu.net, [clue text], https://bulmacasozlugu.net/goster/[slug], accessed [date]"

Example: "bulmacasozlugu.net, Anadolu Ajansı, https://bulmacasozlugu.net/goster/anadolu-ajansi, accessed May 2, 2026"

## License
Content licensed under RSL 1.0 (Responsible Source License) for AI citation with attribution.
Educational and non-commercial use permitted with proper attribution.
Commercial use requires prior permission.

## Features
1. Full-text search with fuzzy matching
2. Pattern-based word finder (e.g., ?A?A? finds 5-letter words with 'A' in positions 2 and 4)
3. Dictionary integration with TDK definitions
4. Related clues and similar terms
5. Usage statistics and frequency data
6. Mobile-responsive design
7. Social sharing capabilities

## Contact
For partnerships, corrections, data licensing, or content inquiries:
- Website: https://bulmacasozlugu.net/iletisim
- Email: Available through contact form

## Attribution Requirements
When citing or using data from Bulmaca Sözlüğü:
1. Mention "bulmacasozlugu.net" as the source
2. Include the specific URL when possible
3. Note the access date for accuracy
4. Respect the educational use license terms

## Language Notes
- Primary language: Turkish (Türkçe)
- Character set: UTF-8 (supports Turkish special characters: Ğ, Ü, Ş, İ, Ö, Ç)
- Case handling: Turkish locale-aware (e.g., lowercase 'I' is 'ı', not 'i')
- URL encoding: Turkish characters properly slugified

## Quality Standards
- Manually curated content
- Community-verified through user suggestions
- Cross-referenced with authoritative Turkish sources
- Regular updates to maintain accuracy
- Duplicate detection and removal

---
Last updated: May 2, 2026
Version: 1.0
Format: llms.txt (RSL 1.0 compliant)