[DX-1520] Add explanation to the use of catalogue and catalog

[letzya]

https://deploy-preview-5084--tyk-docs.netlify.app/docs/nightly/tyk-apis/tyk-portal-api/portal-documentation

https://deploy-preview-5084--tyk-docs.netlify.app/docs/nightly/tyk-portal-api

[github-actions]

PR Reviewer Guide 🔍

⏱️ Estimated effort to review: 3 🔵🔵🔵⚪⚪

🧪 No relevant tests

🔒 No security concerns identified

⚡ Key issues to review Spelling Consistency The document mentions the use of British English in the product but uses American English in the documentation. Ensure consistency in terminology, especially for key terms that might affect user searches and SEO. Code Block Formatting The change from {.copyWrapper} to triple backticks might affect how code is displayed or copied in the documentation. Verify that this change aligns with the documentation's styling guidelines and does not impact functionality. Response Format Consistency The response format for some API calls has been changed from JSON to YAML. Confirm that this change is intentional and consistent with other parts of the documentation.

[github-actions]

PR Code Suggestions ✨

Category	Suggestion	Score
Enhancement	Improve grammar and clarity in the description text The description text contains a typo and is not grammatically correct. Consider revising it to enhance clarity and professionalism. tyk-docs/content/tyk-apis/tyk-portal-api/portal-documentation.md [4] -description: "Descript the endpoint API admin or owner can use to publishing their API in the developer portal" +description: "Description of the endpoints that API admins or owners can use to publish their APIs on the developer portal." Suggestion importance[1-10]: 9 Why: The suggestion corrects a grammatical error and improves the clarity of the description, which enhances the professionalism and readability of the documentation.	9
Best practice	Replace HTML break tags with markdown spacing techniques The use of tags for spacing in markdown is not recommended. Consider using markdown spacing techniques such as multiple newlines or restructuring the content. tyk-docs/content/tyk-apis/tyk-portal-api/portal-documentation.md [9-19] -</br> +<!-- Use a blank line for spacing --> Suggestion importance[1-10]: 8 Why: Using markdown spacing techniques instead of HTML tags is a best practice that ensures better compatibility and readability in markdown files.	8
Maintainability	Streamline the content in the note section for clarity and brevity The note section can be made more concise and clear by removing redundant information and focusing on the key message. tyk-docs/content/tyk-apis/tyk-portal-api/portal-documentation.md [13-18] **Important Note on Spelling:** -While our documentation now uses American English, the product itself, including UI, configuration fields, environment -variables, and APIs endpoints, retain British English spellings. When interacting with the product, please continue -using the British English spellings as they appear in the interface and API. (This means that for existing users nothing -has changed). +Our documentation uses American English, but the product retains British English spellings in the UI, configuration fields, environment variables, and API endpoints. Please use British English when interacting with these elements. Suggestion importance[1-10]: 7 Why: The suggestion makes the note more concise and easier to read, which improves maintainability and user comprehension.	7

[netlify]

✅ PS. Pls add /docs/nightly to the end of url

Name	Link
🔨 Latest commit	f75f299
🔍 Latest deploy log	https://app.netlify.com/sites/tyk-docs/deploys/669608a6e6acbc00088c8a72
😎 Deploy Preview	https://deploy-preview-5084--tyk-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[yurisasuke]

/release to release-5.4

[tykbot]

Working on it! Note that it can take a few minutes.

[tykbot]

@Keithwachira Succesfully merged PR

[yurisasuke]

/release to release-5.3

[tykbot]

Working on it! Note that it can take a few minutes.

[tykbot]

@Keithwachira Succesfully merged PR