Save the Changes

Minor Changes

Sometimes you will encounter small issues in the documentation. Examples of minor changes include:

• Grammar or spelling errors
• Typing errors
• Broken links
• Revising or slightly rephrasing texts for clarity
• Other small, low-impact fixes that don't affect the overall structure or meaning of the page

Such bugs should be fixed directly on the page, without creating a Change Request. You don't need approval, just fix them

When making minor edits, please remember to:

• Mark the changes as "minor". This way you don't send notifications to people following that page (by IRC, mail or RSS) each time you make a minor addition.
• Write a short summary describing the fix (e.g., "fixed typo", "fix broken link" etc.).
• It's preferable to click "Preview" when editing a page with the Wiki editor to view your changes before you save the document. This prevents saving incorrect content and sending "spam" notifications to people who explicitly configured their settings to receive minor ones.

Major Changes

Major changes are edits that impact the structure, organization or content of the documentation. Examples include:

• Creating new documentation (documenting a new feature or adding content to an existing feature).
• Refactoring a documentation page to follow the new migration steps of the Documentation Guide.
• Restructuring navigation, moving content between locations, reorganizing sections.
• Updating many pages at once.

Automatic Documentation Checks on Save

Once you save a page that has the documentation object class attached, certain checks are automatically performed. These checks will help identify whether the page you saved contains any violations of the doc guide. If any issues are found, you will be able to see them directly, allowing you to address them before proceeding further.

Save with Change Request

Major edits you are unsure of may be saved with Change Request, so that they can be properly reviewed and validated by the Documentation Team before being published. You may also ask for feedback on the XWiki forum or Chat, or re-check the documentation guide before starting.

You can:

• request creation of a new Page if you don't have edit rights, or
• create change requests.

Existing Change Requests

When saving with a change request, you can choose whether to group your changes with an existing change request or create a new one. Currently, to do check if there are existing Change Request on a Page, you need to view the "Change Request" tab at the bottom of the page. For example:

Soon there will be also a banner/warning on the page to make this option more visible.

Save New Change Request

If the Page you are editing has in the "Change Request" tab only "Published" change requests or doesn't have any change request, create a new change request. 

Adding Changes to Existing Change Request

If the changes are related to an existing change request, or are concerning a page that already has an opened change request (e.g., you are moving content from a page to another, or convert an old doc page to the new doc guide) put the changes in the same change request so it's easier to review and publish the changes in the pages altogether. For this, select an existing change request.

Edit Change Requests

After saving an edit with change request, you can edit change requests and inspect changes in the rendered diff before saving other edits.