📘 Add shared fields/word_fields reference and make endpoint references clickable#11
Merged
osamasayed merged 27 commits intoquran:mainfrom Jul 1, 2025
Merged
📘 Add shared fields/word_fields reference and make endpoint references clickable#11osamasayed merged 27 commits intoquran:mainfrom
osamasayed merged 27 commits intoquran:mainfrom
Conversation
in random verse endpoint Added missing documentation for existing query parameters supported by the random verse endpoint: - chapter_number - page_number - juz_number - hizb_number - rub_el_hizb_number - ruku_number - manzil_number These parameters were already supported in the API but not reflected in the documentation. This update ensures developers are aware of all available filtering options when using the endpoint.
/tafsirs/{resource_id}/by_ayah/{ayah_key}
Fixed the incorrect response schema shown for the /tafsirs/{resource_id}/by_ayah/{ayah_key} endpoint in the docs.
The autogenerated version via <ApiTabs> was causing runtime crashes due to unresolved OpenAPI store references. Since that approach wasn't working despite correct infoPath and operationId setup, we manually wrote the MDX documentation using standard Docusaurus components.
Tested locally – page now renders successfully and reflects the accurate response structure.
list-ayah-tafsirs and regenerate MDX
Updated the OpenAPI schema (v4.json) for the /tafsirs/{resource_id}/by_ayah/{ayah_key} endpoint to ensure the response structure reflects the actual API output.
The previous crash with <ApiTabs> was due to incorrect or incomplete schema context. After fixing the schema, we ran:
- yarn clean-all
- yarn gen-all
- yarn start
The generated docs now render correctly and reflect the accurate response, eliminating the need for manual overrides.
Fix additional v4 typos
…haf--in-v4.json Fix Mushaf typo
…aceholders-in-v4.json Fix unrendered model placeholders
tokens with actual endpoints
…-tokens-in-v4.json Fix placeholder endpoints
…in-get-todays-plan-api Fix mushafId param docs
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
…fields-and-word_fields Add field reference documentation and links
basit3407
changed the title
…g-other-endpoints docs: link resource references
basit3407
changed the title
mushafId for /v1/goals/get-todays-plan and add shared fields/word_fields reference
osamasayed
requested changes
Jul 1, 2025
basit3407
changed the title
mushafId, add shared fields/word_fields reference, and make endpoint references clickable
osamasayed
approved these changes
Jul 1, 2025
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR includes the following documentation improvements (excluding the previously added
mushafIdparameter, which has now been reverted):field-reference.mdxpage listing supported values for:fields(verse-level fields)word_fields(word-level fields)These are used across multiple endpoints (e.g.
/v4/verses/by_page) and are now referenced with clickable links in the relevant query parameter descriptions./resources/recitationsnow links from endpoints like/recitations/{recitation_id}/by_chapter/.../resources/translationslinked from/translations/{translation_id}/by_chapter/.../resources/tafsirsand/resources/languageslinked from their respective usagesThese improvements enhance cross-navigation and help developers explore related API endpoints more easily.