Sunnah, Hadith & Quran Fact-Checking
Purpose
Ensure all Islamic content in the codebase has:
- •Correct source references (valid hadith numbers, proper collection names)
- •Working verification links (Sunnah.com, Quran.com)
- •Accurate text (Arabic/English matching authentic sources)
- •Appropriate grading (prefer Sahih; note if Da'if/weak)
Verification Workflow
1. Hadith References
Required fields for each hadith:
- •
collection: bukhari, muslim, abudawud, tirmidhi, nasai, ibnmajah - •
hadithNumber: Sunnah.com uses global numbering (e.g., Bukhari 6320, not Book 80 Hadith 17) - •
narrator: Should match Sunnah.com
Verification steps:
- •Build URL:
https://sunnah.com/{collection}:{hadithNumber} - •Fetch the page and verify:
- •Hadith exists (no 404)
- •Arabic/English text matches or is appropriately paraphrased
- •Narrator is correct
- •Grade: prefer Sahih; document if Da'if
- •Link format in HadithTooltip: uses
collectionMapfor URL building
Sunnah.com collection mapping:
- •bukhari, muslim, abudawud, tirmidhi, nasai, ibnmajah
2. Quran References
Required fields:
- •
surah: 1-114 - •
ayahStart,ayahEnd(optional for single verse) - •
surahName,surahNameArabic
Verification steps:
- •Build URL:
https://quran.com/{surah}/{ayah} - •Verify Arabic text matches Uthmani script (minor variants acceptable)
- •Translation should be from a reputable source (e.g., Saheeh International, Muhsin Khan)
- •Audio URLs: islamic.network CDN uses format
.../ar.alafasy/{verse_number}.mp3(verse number = global position in Quran)
Quran verse numbering:
- •Surah 2:255 = Ayat al-Kursi
- •Surah 2:285-286 = Last two verses of Al-Baqarah
- •Surah 112-114 = Three Quls (Al-Ikhlas, Al-Falaq, An-Nas)
3. Common Pitfalls
| Issue | Fix |
|---|---|
| Wrong hadith number (404) | Cross-check different numbering schemes (USC-MSA vs Sunnah.com) |
| Da'if hadith used for essential practices | Prefer Sahih; if Da'if is only source, note the grade |
| Mismatch between hadithSource text and link | Ensure link URL matches the displayed reference |
| Quran audio verse number wrong | Use global verse index (e.g., 2:255 = verse 262 in standard Uthmani) |
4. Key Verification Sources
- •Hadith: https://sunnah.com (primary)
- •Quran text/translation: https://quran.com
- •Quran API: https://api.alquran.cloud (for programmatic verification)
- •Audio: https://cdn.islamic.network/quran/audio/
Fact-Check Checklist
When adding or reviewing Islamic content:
- • Every hadith has valid Sunnah.com link
- • Hadith number matches collection (Bukhari 1-7563, Muslim 1-3030, etc.)
- • Quran verses have correct surah:ayah
- • Arabic text matches authenticated source
- • Translation is accurate paraphrase
- • Weak (Da'if) hadith are noted when used
- • No conflicting references (e.g., "Muslim 234" when 234 is wrong)