feat(openapi/content): add foot_notes to GET /quran/translations/{translation_id}Feat foot notes (#17)

* docs: document support for location-based filters
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.

* fix: correct response schema for:
/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.

* fix(docs): correct response schema for
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: correct tafsir typos

* Fix Mushaf typo in content API docs

* regenerated api docs after fixing "Mushaf" typos

* Replace unrendered model placeholders

* Regenerated api docs after fixing model names

* Replace placeholder endpoints in v4.json

* regenerated api docs after replacing endpoint
tokens with actual endpoints

* docs: document mushafId param

* Regenerated the docs after the fix

* Add field reference page and link in API spec

* Regenerated api docs

* Fix unicode escapes in field reference

* Clarify qpc_uthmani_hafs description

* docs: link resource references

* regenerated api docs

* Revert "Merge pull request #16 from basit3407/codex/update-docs-for-mushafid-in-get-todays-plan-api"

This reverts commit c498c43, reversing
changes made to 0969369.

* Add SDK documentation

* Update SDK docs

* Revert "Merge pull request #19 from basit3407/codex/generate-new-api-documentation-for-docusaurus"

This reverts commit 66e1279, reversing
changes made to 25f0988.

* Add translation integrity admonition via JSON

* regenerated api docs

* docs(openapi): document segments=true for Chapter Reciter Audio File in v4.json (param, schema, and examples)

* regenerated api docs

* docs(openapi): fix List Surah Recitation response (remove segments/timestamps; correct schema & examples)

* regenerated api docs

* update api docs

* feat(openapi/content): add foot_notes to
GET /quran/translations/{translation_id}

Add optional boolean query param foot_notes (default: false).

When foot_notes=true, include foot_notes object mapping footnote IDs (from <sup> tags) to their text.

Update response schema and example to document the foot_notes map.

No MDX changes; docs will be generated from openAPI/content/v4.json.

Affected:
openAPI/content/v4.json

* Regenerated content api docs after the last update

* fixes

* Ready to merge

Author: basit3407