RWS · kvantassell-rws · Jul 24, 2025 · Jul 24, 2025
diff --git a/README.md b/README.md
@@ -1,23 +1,13 @@
-# XPP-api-docs
+# XPP API Docs
 
 ## What is it?
 
-This the main repository for the XPP Public API documentation.
+This the main repository for XPP RESTful API’s documentation.
 
 ## Can I contribute?
 
 Anyone is welcome to contribute to the public XPP API documentation by making a pull request into the master repository.
 
-
-The documentation is split into the following sections:
-- Articles
-  - This section hosts a series of usefull article on:
-    - how to get started with writing plug-ins for XPP
-    - how to best use the public APIs
-    - how to troubleshoot common issues
-- API Concepts
-  - This section hosts the main guidelines on using the Public API along with the API References
-
 ### Getting started with your contribution
 The documentation is built using a static documentation generator called [DocFX](https://dotnet.github.io/docfx/). 
 The documentation content is saved in *Markdown* files and then built into a website using [DocFX](https://dotnet.github.io/docfx/). The table of content is saved into separate *toc.yml* files.
@@ -29,7 +19,7 @@ In order for you to make a contribution directly please follow the next steps:
   - You can use tools such as *Notepad++* or *Visual Studio Code* to edit the content
 - Create a Pull Request with your changes. 
   - This pull request will be reviewed for correctness by one of our technical writers
-- Once your pull request has been approved and committed into the *main* branch, an automatic pipeline will be triggered which will push your changes to the [live documentation site](https://rws.github.io/studio-api-docs/index.html)
+- Once your pull request has been approved and committed into the *main* branch, an automatic pipeline will be triggered which will push your changes to the [live documentation site](https://rws.github.io/xpp-api-docs/index.html)
 - if you wish to test your changes locally you can follow the [DOCFX Installation guideline](https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html) and [build the entire solution locally](https://dotnet.github.io/docfx/tutorial/walkthrough/walkthrough_create_a_docfx_project.html)
 - Our documentation automatically fills in the product name and other details so you don't have to make the changes manually if we decide to update the product name. Use the '<var:VariableName>' construct to tell our documentation engine to fill in the info for you. Here are the constructs available at this point:
 

diff --git a/api/.gitignore b/api/.gitignore
diff --git a/api/index.md b/api/index.md
diff --git a/apiconcepts/overview.md b/apiconcepts/overview.md
diff --git a/apiconcepts/toc.yml b/apiconcepts/toc.yml
diff --git a/articles/intro.md b/articles/intro.md
diff --git a/articles/toc.yml b/articles/toc.yml
diff --git a/docfx.json b/docfx.json
@@ -3,40 +3,24 @@
     "content": [
       {
         "files": [
-          "api/**.yml"
-        ]
-      },
-      {
-        "files": [
-          "articles/**.md",
-          "articles/**/toc.yml",
           "toc.yml",
-          "*.md"
-        ]
-      },
-      {
-        "files": [
-          "apiconcepts/**.md",
-          "apiconcepts/toc.yml"
+          "index.md"
         ]
       }
     ],
     "resource": [
       {
         "files": [
           "**/images/**",
-          "**/*.json",
-          "**/*.html",
-          "**/*.js",
-          "**/*.css"
+          "docs/*.json",
+          "docs/*.html",
+          "docs/*.js",
+          "docs/*.css"
         ]
       }
     ],
     "overwrite": [
       {
-        "files": [
-          "api/**.md"
-        ],
         "exclude": [
           "obj/**",
           "_site/**"

diff --git a/apiconcepts/documentation/LICENSE → docs/LICENSE b/apiconcepts/documentation/LICENSE → docs/LICENSE
diff --git a/apiconcepts/documentation/NOTICE → docs/NOTICE b/apiconcepts/documentation/NOTICE → docs/NOTICE
diff --git a/apiconcepts/documentation/index.css → docs/index.css b/apiconcepts/documentation/index.css → docs/index.css
diff --git a/apiconcepts/documentation/index.html → docs/index.html b/apiconcepts/documentation/index.html → docs/index.html
diff --git a/...epts/documentation/swagger-initializer.js → docs/swagger-initializer.js b/...epts/documentation/swagger-initializer.js → docs/swagger-initializer.js
diff --git a/...ncepts/documentation/swagger-ui-bundle.js → docs/swagger-ui-bundle.js b/...ncepts/documentation/swagger-ui-bundle.js → docs/swagger-ui-bundle.js
diff --git a/...mentation/swagger-ui-standalone-preset.js → docs/swagger-ui-standalone-preset.js b/...mentation/swagger-ui-standalone-preset.js → docs/swagger-ui-standalone-preset.js
diff --git a/apiconcepts/documentation/swagger-ui.css → docs/swagger-ui.css b/apiconcepts/documentation/swagger-ui.css → docs/swagger-ui.css
diff --git a/apiconcepts/documentation/xpp-rest.css → docs/xpp-rest.css b/apiconcepts/documentation/xpp-rest.css → docs/xpp-rest.css
diff --git a/apiconcepts/documentation/xpp-rest.js → docs/xpp-rest.js b/apiconcepts/documentation/xpp-rest.js → docs/xpp-rest.js
diff --git a/apiconcepts/documentation/xpp-rest.json → docs/xpp-rest.json b/apiconcepts/documentation/xpp-rest.json → docs/xpp-rest.json
diff --git a/index.md b/index.md
@@ -1,9 +1,16 @@
-# Access the XPP APIs
+# XPP RESTful Web Services
 
-## [Learn more about XPP APIs](apiconcepts/overview.md) 
-Learn more about the APIs and what you can achieve with them.
+Welcome! This site is for developers building tools with XPP RESTful Web Services.
+Here you will find installation guides, configuration instructions, usage examples, and best practices for integrating and extending the capabilities of XPP through its RESTful APIs.
 
-## [Articles](articles/intro.md)
-Read articles on how to get more out of XPP.
+## Installation
 
-RWS
+For complete installation and setup information, please refer to the **[XPP Technical Documentation](https://docs.rws.com/en-US/xpp-restful-web-services-1-6-1248383/welcome-to-the-xpp-restful-web-services-documentation-411242)** on the official RWS documentation portal.
+
+## API Documentation
+
+The documentation for all API calls is available in **<a href="docs/index.html" target="_BLANK">this human-readable HTML web app</a>** that provides a structured overview of all endpoints, request/response formats, supported parameters, and example payloads.
+
+## OpenAPI Specification
+
+The documentation above is derived from **<a href="docs/xpp-rest.json" target="_BLANK">this JSON file</a>** that conforms to version 3.1 of the **[OpenAPI Specification](https://spec.openapis.org/oas/v3.1.0.html)**.
diff --git a/toc.yml b/toc.yml
@@ -1,6 +1,2 @@
 - name: XPP
-  href: index.md
-- name: Articles
-  href: articles/
-- name: API
-  href: apiconcepts/
+  href: index.md