Skip to content

Conversation

@mendix-nleimer
Copy link
Contributor

@mendix-nleimer mendix-nleimer commented Nov 19, 2025

AI assisted + human revied language and formatting overhaul

Additional changes
Getting started

  • adding comment about custom proxy settings
  • moving marketplace links under system requirements
    Installation and configuration
  • improved language and clarity of quick start guide and removing out of place marketplace links (fits neither into quick start or advanced config and quick starts links to them already in the appropriate step)
  • adding documentation about new features and advanced configuration of Workspaces and Stations
    Troubleshooting
  • adding more troubleshooting tips for the WS Client

@mendix-nleimer
Copy link
Contributor Author

@katarzyna-koltun-mx Could you please inspect the suggested new document structure of Installation and configuration and leave feedback? The goal is to add a more advanced configuration section to describe all the additional features that haven't been documented so far and that would blow up the scope of the quick start guide.

@mendix-nleimer mendix-nleimer marked this pull request as ready for review November 21, 2025 14:33
@mendix-nleimer mendix-nleimer changed the title Overall to Workstation 3.1 scope Language overhaul and Workstation 3.1 scope updates Nov 21, 2025
@katarzyna-koltun-mx
Copy link
Collaborator

A number of the changes suggested here are valid (e.g. changing "shopfloor" to "shop floor" - both are correct, but we use "shop floor" in other materials; expanding on the SEO summaries). However, others are superfluous (e.g. changing "but" to "however" or "directly interacts" to "interacts directly", where both forms are correct and the meaning is the same). There are also changes that go against our stylesheet (e.g. bolding parts of text for decoration). To be discussed during the meeting today.

* Install: `sudo apt install ./workstation_X.X.X_arm64.deb`
* Install card reader dependencies: `sudo apt install pcscd libcap2-bin`
* Download the [Linux](https://marketplace.mendix.com/link/component/247459) version of the Client.
* Run the following command to install: `sudo apt install ./workstation_X.X.X_arm64.deb` (replace *X.X.X* with the actual version number of the downloaded .deb package).
Copy link
Contributor Author

Choose a reason for hiding this comment

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

To Do: update to latest package name

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants