Add XML declaration example to XSLT mediator documentation

[ChaninduImanjith]

Purpose

Resolves #1681

Goals

Add documentation on how to include the XML declaration (<?xml version="1.0" encoding="utf-8"?>) in WSO2 MI output payloads using the WRITE_XML_DECLARATION axis2 property.

Approach

Added Example 5 to the XSLT mediator documentation explaining how to use the WRITE_XML_DECLARATION property with a code example and expected output.

User stories

As a WSO2 MI developer, I want to know how to add an XML declaration to my output payload so that downstream systems that require it can process the response correctly.

Release note

Added documentation for adding XML declaration to output payloads using the WRITE_XML_DECLARATION axis2 property in the XSLT mediator docs.

Documentation

en/docs/reference/mediators/xslt-mediator.md

Training

N/A

Certification

N/A - Documentation-only update.

Marketing

N/A

Automation tests

N/A - No code changes introduced.

Security checks

• Followed secure coding standards? Yes
• Ran FindSecurityBugs plugin? N/A
• No keys, passwords, or secrets committed? Yes

Samples

N/A

Related PRs

N/A

Migrations

N/A

Test environment

Tested on Fedora OS (local documentation verification).

Learning

Solution referenced from https://stackoverflow.com/questions/13019908/wso2-xml-declaration

[coderabbitai]

Warning

Review limit reached

@ChaninduImanjith, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 55 minutes and 4 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more credits in the billing tab to continue.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 360763f1-7016-4eee-b174-f86ddb31a21a

📥 Commits

Reviewing files that changed from the base of the PR and between f3e7aa6 and d331ed2.

📒 Files selected for processing (1)

• en/docs/reference/mediators/xslt-mediator.md

📝 Walkthrough

Walkthrough

The XSLT mediator reference adds “Example 5 - Adding XML declaration to the output.” It documents the default output behavior, shows how to set the WRITE_XML_DECLARATION property in axis2 scope, includes a sequence example, and shows the resulting XML output with the declaration.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and accurately summarizes the documentation-only change.
Description check	✅ Passed	The description follows the template closely and includes relevant details for all major sections.
Linked Issues check	✅ Passed	The PR addresses issue #1681 by documenting how to add an XML declaration using WRITE_XML_DECLARATION.
Out of Scope Changes check	✅ Passed	The change set appears scoped to the requested documentation update with no unrelated additions.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

Pull request overview

This PR updates the XSLT mediator documentation to explain how to include an XML declaration in WSO2 MI output payloads by setting the WRITE_XML_DECLARATION Axis2 property.

Changes:

• Adds a new “Example 5” showing how to enable WRITE_XML_DECLARATION in the axis2 scope.
• Provides a short snippet, a full sequence example, and the expected XML output including the declaration.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[chanikag]

Let's have the original note.

[ChaninduImanjith]

Done! Reverted the Copilot suggestion and restored the original note. @chanikag