docs: move documentation from ix to ix-docs

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,8 @@
 contact_links:
+  - name: Bug report or feature request for the official iX documentation
+    url: https://github.com/siemens/ix-docs/issues
+    about: Please use this link to report bugs or request features related to the official iX documentation.
+
   - name: Support Question 🤔
     url: https://community.siemens.com/c/ix/
     about: This issue tracker is not for support questions. Please post your question to the Siemens Community Forum.

.github/PULL_REQUEST_TEMPLATE

@@ -22,7 +22,7 @@ A pull request can only be merged if all of these conditions are met (where appl
 - [ ] 🦮 Accessibility (a11y) features were implemented
 - [ ] 🗺️ Internationalization (i18n) - no hard coded strings
 - [ ] 📲 Responsiveness - components handle viewport changes and content overflow gracefully
-- [ ] 📄 Documentation was reviewed/updated (`pnpm run docs`)
+- [ ] 📄 Documentation was reviewed/updated [siemens/ix-docs](https://github.com/siemens/ix-docs)
 - [ ] 🧪 Unit tests were added/updated and pass (`pnpm test`)
 - [ ] 📸 Visual regression tests were added/updated and pass ([Guide](https://github.com/siemens/ix/blob/main/CONTRIBUTING.md#visual-regression-testing))
 - [ ] 🧐 Static code analysis passes (`pnpm lint`)

.github/workflows/build.yml

@@ -22,6 +22,12 @@ jobs:
       - name: Lint
         run: pnpm lint
 
+      - name: Documentation
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation-${{ github.run_attempt }}
+          path: ./packages/documentation/build
+
   visual-testing-core:
     needs: [build]
     timeout-minutes: 10

.github/workflows/pr.yml

@@ -61,26 +61,19 @@ jobs:
       - uses: ./.github/workflows/actions/turbo
 
       - name: Build
-        run: pnpm build --cache-dir=.turbo --filter \!documentation
+        run: pnpm build --cache-dir=.turbo
 
       - name: Lint
         run: pnpm lint
 
       - name: Check for local development changes
         run: ./scripts/lint-build.sh
 
-  build-docs:
-    needs: [changes, build]
-    if: ${{ needs.changes.outputs.docs_any_changed == 'true' || github.event.pull_request.user.login == 'dependabot[bot]' }}
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - uses: ./.github/workflows/actions/turbo
-
-      - name: Build
-        run: pnpm build --cache-dir=.turbo --filter documentation
+      - name: Documentation
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation-${{ github.run_attempt }}
+          path: ./packages/documentation/build
 
   visual-testing-core:
     if: ${{ needs.changes.outputs.core_any_changed == 'true' || github.event.pull_request.user.login == 'dependabot[bot]' }}

CONTRIBUTING.md

@@ -222,8 +222,9 @@ docker run -v $(pwd):/work/ -w /work -it mcr.microsoft.com/playwright:v1.50.0-no
 
 ### Modify and preview documentation
 
-1. Run `pnpm start --filter documentation` from within the `root` directory.
-2. Locate the docs to modify inside `/packages/documentation/docs/`.
+The documentation source is maintained in a separate repository: [siemens/ix-docs](https://github.com/siemens/ix-docs). This repository contains all relevant markdown files and Figma assets.
+
+If you need to update only the preview or code examples, you can do so by following the instructions in the next section.
 
 #### Preview and example code
 
@@ -236,20 +237,6 @@ These packages contain playground applications to explore and test the respectiv
 The preview source code for the documentation is also located inside the `x-test-app`'s. (`src/preview-examples`)
 These preview-examples will be translated to markdown files and get copied into `./packages/documentation/docs/auto-generated/previews`.
 
-#### Figma integration
-
-> You need to have access to the internal figma library
-
-To see all image references it is necessary to create a personal access token (https://www.figma.com/developers/api#access-tokens).
-
-Store the token as environment variable "FIGMA_API_TOKEN" or in the .env file inside project root.
-
-Serve documentation [locally](http://localhost:3000/siemens-ix/)
-
-```sh
-pnpm start --filter=documentation
-```
-
 ### Submit Pull Request
 
 1. [Create a new pull request](https://github.com/siemens/ix/compare) with the `main` branch as the `base`. You may need to click on `compare across forks` to find your changes.

packages/documentation/.gitignore

@@ -1,31 +1 @@
-# Dependencies
-/node_modules
-
-# Production
-/build
-
-# Generated files
-.docusaurus
-.cache-loader
-
-# Misc
-.DS_Store
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
-
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-
-static/demo/v*/angular
-static/demo/v*/html
-static/demo/v*/react
-static/demo/v*/vue
-static/demo/v*/preview
-static/usage
-
-
-docs/autogenerated
+build/

packages/documentation/README.md

@@ -1,41 +1,5 @@
-# Website
+# Documentation for Siemens Industrial Experience
 
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+> The documentation and all of it's markdown files where moved to [https://github.com/siemens/ix-docs](https://github.com/siemens/ix-docs).
 
-### Installation
-
-```
-$ yarn
-```
-
-### Local Development
-
-```
-$ yarn start
-```
-
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
-
-### Build
-
-```
-$ yarn build
-```
-
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
-
-### Deployment
-
-Using SSH:
-
-```
-$ USE_SSH=true yarn deploy
-```
-
-Not using SSH:
-
-```
-$ GIT_USER=<Your GitHub username> yarn deploy
-```
-
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+This package contains the artifacts for uploading the preview examples of the test-apps.