From 3a43d54a445436d6f7c9d70158ae8d350a7fd341 Mon Sep 17 00:00:00 2001
From: Aric Camarata <aric.camarata@gmail.com>
Date: Sun, 8 Mar 2026 17:10:55 -0400
Subject: [PATCH] docs: add Architecture and Acknowledgments sections; rename
 Related Packages to Related

---
 README.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7ae51aa..42513ad 100644
--- a/README.md
+++ b/README.md
@@ -117,18 +117,26 @@ final h = toHijri(
 );
 ```
 
+## Architecture
+
+The UAQ engine performs a binary search over the 184-entry table — O(log 183) per conversion. The FCNA engine computes new moon times using the Meeus Ch. 49 algorithm. The registry pattern lets consumers add custom calendar engines at runtime.
+
 ## Compatibility
 
 - Dart SDK >= 3.7.0
 - Works with Flutter
 - Zero external dependencies
 
-## Related Packages
+## Related
 
 - [hijri-core](https://www.npmjs.com/package/hijri-core) (TypeScript/npm)
 - [nrel-spa](https://www.npmjs.com/package/nrel-spa) (Solar position algorithm)
 - [pray-calc](https://www.npmjs.com/package/pray-calc) (Islamic prayer times)
 
+## Acknowledgments
+
+The Umm al-Qura calendar table is derived from data published by the King Abdulaziz City for Science and Technology (KACST), Saudi Arabia. The FCNA new moon algorithm follows Jean Meeus, "Astronomical Algorithms," 2nd ed., Chapter 49.
+
 ## License
 
 MIT. Copyright (c) 2026 Aric Camarata.