Skip to content

docs: follow libmuslim 2026.08.20, and correct two claims the release made false - #33

Merged
rizukirr merged 1 commit into
mainfrom
libmuslim-2026.08.20
Aug 20, 2026
Merged

docs: follow libmuslim 2026.08.20, and correct two claims the release made false#33
rizukirr merged 1 commit into
mainfrom
libmuslim-2026.08.20

Conversation

@rizukirr

Copy link
Copy Markdown
Member

Follows 2026.08.20, prayertimes.h v0.2.1.

Download pins

2026.08.19 becomes 2026.08.20, and the tag-versus-header note now reads v0.2.1 alongside hijri.h and timezone.h at v0.1.0.

This matters more than a version bump usually would. The 2026.08.19 asset reports prayers out of order at high latitude and returns a formula artifact as an asr time, and its header calls itself v0.2.0 exactly as the fixed one did before the bump. A reader following the old curl command could not tell the difference by reading the file.

Two claims the release made false

Both were checked by running the libraries, not by reading the pages.

The Dart quick-start had the wrong time. It said the Tromso midsummer call returns a Fajr of 00:27 under the default MWL parameters.

DOC fajr 2026-06-21T00:24:00.000Z

It returns 00:24. libmuslim#68 now solves the whole polar day at the reference latitude rather than borrowing only sunrise and sunset, so the value moved by three minutes.

Both the C and Dart pages claimed MWL and Moonsighting resolve every field at every latitude. They no longer do.

libmuslim#69 stopped reporting asr where the Sun casts no shadow. There is a narrow band, four days a year at Longyearbyen, where the separation from the declination sits between 90 and 90.833 degrees: the Sun is visible only by refraction, so sunrise exists and fajr, maghrib and isha all resolve, but nothing casts a shadow. On those days asr alone is non-finite, even under MWL.

Carrying a reference latitude is not the same as always resolving, and both pages now say so.

Left alone deliberately

The remaining v0.2.0 mentions across the docs are historical statements about when sunrise and dhuha were removed. Those are still accurate and changing them to v0.2.1 would make them wrong.

Verification

npm run build     SUCCESS

… made false

Download pins move from 2026.08.19 to 2026.08.20, and the tag-versus-header
note now reads prayertimes.h v0.2.1.

Two statements stopped being true and were verified against the libraries
rather than edited by inspection.

The Dart quick-start said the Tromso midsummer call returns a Fajr of
00:27 under the default MWL parameters. It returns 00:24. libmuslim#68
now solves the whole polar day at the reference latitude instead of
borrowing only sunrise and sunset, so the value moved. Checked by running
the documented call.

Both the C and Dart API pages said MWL and Moonsighting resolve every
field at every latitude. They no longer do. libmuslim#69 stopped
reporting asr where the Sun casts no shadow, and there is a narrow band,
four days a year at Longyearbyen, where the Sun is visible only by
refraction: sunrise exists and fajr, maghrib and isha all resolve, but
nothing casts a shadow, so asr alone is non-finite even under MWL.

The other v0.2.0 mentions across the docs are historical statements about
when sunrise and dhuha were removed, and remain correct.

npm run build succeeds.
@vercel

vercel Bot commented Aug 19, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
muslimtify Ready Ready Preview Aug 19, 2026 1:17pm

@rizukirr
rizukirr merged commit 3d5e2eb into main Aug 20, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant