Skip to content

Prepare v3.1#206

Merged
abravosuse merged 84 commits into
latestfrom
prepare-v3.1
May 28, 2026
Merged

Prepare v3.1#206
abravosuse merged 84 commits into
latestfrom
prepare-v3.1

Conversation

@arbulu89
Copy link
Copy Markdown
Contributor

@arbulu89 arbulu89 commented May 27, 2026

Prepare documentation for 3.1.0 version.

Dmitri Popov and others added 30 commits October 16, 2025 15:28
* Restructure trento install section

* Remove partial as it was included in kubernetes partial

* Aligned naming of partial and added revdate to kubernetes
* API Keys Management RFC

* Remove sections related to token changes/regeneration and related invalidation

* Rename API Key to Personal Access Token

* Change from :name to :jti in pat revoking API route

* Move image to correct location

* Fix typos

* Add reference to invalidating disabled users' PATs

* use `eg` rather than `ie`

* Add reference to alternative about allowing selecting scopes for a PAT

* Polish unnecessary options, remove image

* Add section about pat metadata storage

* Add section with JWT rationale

* Tracked JWKS alternative

* Add reference to menu

* Fix PR number reference

* Revisit token retrieval to leverage existing endpoints

* Reframe with PATs as opaque tokens
* Note the usage of different certbot nginx package names

---------

Co-authored-by: Dmitri Popov <dpopov@suse.com>
* Fix TRNT-3895

* Add feedback
* Update docs to use new wanda location in nginx and OAS support

* Fix checks servirce url variable name
* Extend with token introspection endpoint authentication

* Add extra PRO to option 3

* Extend options

* Add proposed current solution
* Add token introspection docs

* Add traefik usage clarification

* Remove placeholder from nginx config doc
* Remove docker from user facing docks

* Remove container and docker mentions

* Remove SP3

* Add env for wanda

* Use vars and upcast rpm

* Add explicit sle 16.0
* Update systemd install

* Remove ip access note

* Update prometheus with sle 16.0 instructions
* Add PATs documentation

* Update trento/adoc/personal-access-tokens.adoc

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Add user manager notes

* Fix links in main readme

* Add note about changing user permissions and user deletion

* Remove unnecessary path part in main readme

* Improve image titles

* Fix section name

* Rephrase future form to present

* Update trento/adoc/trento-personal-access-tokens.adoc

Co-authored-by: Dmitri Popov <dpopov@suse.com>

* Update trento/adoc/trento-personal-access-tokens.adoc

Co-authored-by: Dmitri Popov <dpopov@suse.com>

* Update trento/adoc/trento-personal-access-tokens.adoc

Co-authored-by: Dmitri Popov <dpopov@suse.com>

* Update trento/adoc/trento-personal-access-tokens.adoc

Co-authored-by: Dmitri Popov <dpopov@suse.com>

* Update trento/adoc/trento-personal-access-tokens.adoc

Co-authored-by: Dmitri Popov <dpopov@suse.com>

* Update trento/adoc/trento-personal-access-tokens.adoc

Co-authored-by: Dmitri Popov <dpopov@suse.com>

* Update trento/adoc/trento-personal-access-tokens.adoc

Co-authored-by: Dmitri Popov <dpopov@suse.com>

* Update trento/adoc/trento-personal-access-tokens.adoc

Co-authored-by: Dmitri Popov <dpopov@suse.com>

* Remove unnecessary introducion section

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Dmitri Popov <dpopov@suse.com>
* Add local docs build

* Fix selinux permission

* Add workflow guide
* prometheus integration

* blank space at the end of the agent installation file

* including documentation about installation on 16

* Using code block for flag to install prometheus in a particular node

* Removing reference to prometheus architecture

---------

Co-authored-by: Dmitri Popov <dpopov@suse.com>
* Apply  feedback

* Add 2.5 reference without sle 16.0
* Describe correlation feature

* Add feedback

* Add revdate and bullet points

---------

Co-authored-by: EMaksy <emaksymenko@suse.de>
* Integrate MCP server docs: Add architecture, and integration docs.

* Restructure Installation: Split the install section into modular articles and reworked Helm/systemd flows using partials.

* Update Architecture: Replace diagrams and SVGs to reflect new MCP structure and host docs.

* Refine Configuration: Add specific systemd network requirements, reverse proxy mentions, and MCP host variables.

* General Cleanup: Fix linter errors, standardize naming, and update document revision dates.

---------

Signed-off-by: Antonio Gamez Diaz <antonio.gamez@suse.com>
Co-authored-by: Antonio Gamez Diaz <antonio.gamez@suse.com>
* initial draft

* initial draft

* internal timemouts clarified

* reference to the activity log section

* Addition of revdate

* Content review using SUSE Documentation Style Guide NotebookLLM
* add cluster requirements section

* move cluster section after sap req

* Migration of sec-trento-installation-prerequisites subsection content to the sec-trento-server-requirements and sec-trento-agent-requirements subsections

---------

Co-authored-by: abravosuse <alberto.bravo@suse.com>
antgamdia and others added 21 commits April 1, 2026 13:01
Signed-off-by: Antonio Gamez Diaz <antonio.gamez@suse.com>
Signed-off-by: Antonio Gamez Diaz <antonio.gamez@suse.com>
* Adds analytics docs

* Adds analytics to trento guide

* Changed the position of Analytics page
Signed-off-by: Antonio Gamez Diaz <antonio.gamez@suse.com>
Signed-off-by: Antonio Gamez Diaz <antonio.gamez@suse.com>
* Add docs update draft

* Reduce duplicated information

* add content

* add examples and content

* remove duplicated docs

* Update the antora documents

* update antora docs ui information

* add automation ntoes and versioning

* add maintainer guide and pipeline

* add ownership notes

* Reorder nav

* clarify main readme

* Update the git workflow

* clarify ui build
* add support config description

* update revdate
…n name (#191)

* Add resource refresh operation docs

* Rename cluster start/stop operations

* Fix resource maintenance operation pre-condition
* Document complete database layer operations

* Correction to minor wording change for introduction to site operations

---------

Co-authored-by: Alberto Bravo <abravo@SUSE-008561.localdomain>
* Add operation usage principle about target heartbeat

* Add dot to end of sentence
* Visualization of versions of different components in About view

* Minor style and grammar corrections
Signed-off-by: Antonio Gamez Diaz <antonio.gamez@suse.com>
Co-authored-by: Copilot <copilot@github.com>
Co-authored-by: Alberto Bravo <alberto.bravo@suse.com>
The host details view now includes filesystem and swap utilization dashboards in addition to the CPU and Memory utilization ones.
The Trento supportconfig plugin generates a scenario dump when executed in a systemd deployment.
* configure prometheus for SLES 16

* update auth section

* remove mentions to bearer as default auth

* add exported metrics table

* add manual prometheus setup

* Filesystem and swap utilization are also rendered as graphical dashboards.

* final review

---------

Co-authored-by: Alberto Bravo <alberto.bravo@suse.com>
…205)

* Updates on helm deployments procedures regarding the write endopoint

* Removal of experimental flag and obsolete runner references in helm commands
* revision_history, compatibility matrix and version highlights

* Fix malformed revhistory list in trento guide docinfo

Agent-Logs-Url: https://github.com/trento-project/docs/sessions/50f7fc76-4860-44ef-9e09-831cf5b9e67d

Co-authored-by: abravosuse <91731013+abravosuse@users.noreply.github.com>

* Inclusion of release dates

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
@arbulu89 arbulu89 changed the base branch from main to latest May 27, 2026 13:49
Copy link
Copy Markdown
Collaborator

@abravosuse abravosuse left a comment

Choose a reason for hiding this comment

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

Hey @arbulu89 . In the end I wasn't able to make the doc build work in my local deployment and it was easier for me to do the review directly here. As I told you before, the only changes to be rolled back are chose in ansible adoc file because we have not yet released the new package. Everything else in the other adoc files seem to be in order.

Comment thread trento/adoc/trento-ansible-install.adoc Outdated
Comment thread trento/adoc/trento-ansible-install.adoc Outdated
Removing Diagnostics tooling as this is not yet available.
Removing section about support tooling as this is not yet available.
@abravosuse abravosuse self-requested a review May 27, 2026 16:08
Copy link
Copy Markdown
Collaborator

@abravosuse abravosuse left a comment

Choose a reason for hiding this comment

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

I have commited the changes to the ansible adoc file. We are good too go.

@arbulu89 arbulu89 marked this pull request as ready for review May 28, 2026 06:32
@abravosuse abravosuse merged commit 868ecc5 into latest May 28, 2026
8 checks passed
@abravosuse abravosuse deleted the prepare-v3.1 branch May 28, 2026 06:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

9 participants