Skip to content

Feature ETP-3885: Improve Etendo RX doc based on feedback#664

Open
mapenglishservices wants to merge 2 commits into
developfrom
feature/ETP-3885
Open

Feature ETP-3885: Improve Etendo RX doc based on feedback#664
mapenglishservices wants to merge 2 commits into
developfrom
feature/ETP-3885

Conversation

@mapenglishservices

Copy link
Copy Markdown
Collaborator

Summary

  • Rewrote the Etendo RX page as a platform overview (Architecture & Services table, Key Capabilities, Getting Started with 4 steps) to address feedback that the page only covered SSO login
  • Fixed the Spanish translation to match the updated English source: corrected heading levels, field label (CostoValor), untranslated string (1 hour1 hora), and missing Getting Started steps
  • Added Anaís terminology KB (overrides/assets/anais_translation_kb.json) — all translated UI terms verified against it

Test plan

  • Both EN and ES pages render correctly on the docs site
  • All internal anchor links in the ES file resolve correctly
  • All image references exist under docs/assets/
  • mkdocs build passes (4 pre-existing material/search warnings in mkdocs.yml are unrelated to this PR)

🤖 Generated with Claude Code

@mapenglishservices
mapenglishservices changed the base branch from main to develop May 4, 2026 18:35

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Etendo RX documentation (EN + ES) to present RX as a platform overview (architecture/services, capabilities, and onboarding steps) and aligns the Spanish translation with the updated English content.

Changes:

  • Reworked both pages to add an Overview, Architecture/Services table, Key Capabilities, and a 4-step Getting Started section.
  • Restructured the Authentication section heading hierarchy and refined wording/labels (including ES translation fixes).

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 5 comments.

File Description
docs/developer-guide/etendo-classic/bundles/platform/etendo-rx.md Rewrites the page into an RX platform overview and reorganizes Authentication/SSO/OAuth content.
docs/es/developer-guide/etendo-classic/bundles/platform/etendo-rx.md Mirrors the new EN structure in Spanish and corrects translation issues and heading levels.

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

Etendo allows you to authenticate using these external provider accounts: **Google**, **Microsoft**, **LinkedIn**, **GitHub** and **Facebook**. Using the Single Sign-On (SSO) protocol is possible due to the integration through:

- [EtendoAuth Middleware Service](#set-up-etendo-to-login-with-etendoauth-middleware-service-recommended)
- [Auth0 Custom Implementation](#how-to-integrate-your-own-auth0-login-provider-with-etendo)

| Service | Default Port | Responsibility |
|---|---|---|
| **Config Service** | `8888` | Centralised configuration server. Reads settings from `src-rx/rxconfig/` YAML files and distributes them to all other RX services when they start. |

## Getting Started

Follow these steps to initialise and run Etendo RX.
Comment on lines +86 to +90
If you are using the Dockerised deployment described in the full guide, you can also start the containers with `./gradlew resources.up`.

**Further reading**

- [Etendo RX Getting Started](../../../etendo-rx/getting-started.md) — full setup guide including requirements, RX Config window initialisation, and Docker-based startup
title: Etendo RX
---

# Etendo RX
@mapenglishservices mapenglishservices added the documentation Improvements or additions to documentation label May 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants