Experience the power to view and edit Artifacts as documents in Tuleap 15.10! Explore seamless integration and enhanced functionality for a more intuitive project management experience.
Tech preview: view and edit Artifacts as documents
Mixing Artifacts and Documents is not exactly something new, we have been working on the subject since a while with Baseline or Document Generation features. These features were designed mainly for project teams that need to produce documents for communication, sharing, compliance, etc. The idea is that structured items (bugs, user stories, features) are easier for daily work compared to a document.
The return of the Document
The main advantage of documents over artifacts is their low entry barrier for both reading and writing. We are accustomed to reading texts sequentially, with a logical order of sections. Authors can introduce concepts and reuse them later without re-explaining everything. Readers can quickly scan text, scroll up and down if something is unclear, and avoid constant cross-referencing like “this comes after story #…” or “please refer to epic #… for general definitions.”
Thanks for asking kid !
Let’s talk about…
Artidoc
Artidoc is a new plugin for Tuleap Enterprise Edition that aims to provide an excellent user experience for reading and writing documents without giving up efficiency of day to day work by engineering teams.
The goal is to offer roles that write things down (architects, product owners, designers) a familiar, easy-to-use, and efficient tool. Meanwhile, implementation roles can easily add metadata, link technical details for traceability, and track project progress. This is possible because documents are made of artifacts.
The core component of an Artidoc is a section. A section consists of a title and a paragraph, which translate to an artifact’s title and description. When a new section is added, it’s saved as an artifact behind the scenes.
Sections can also be edited, and changes will be saved as new versions of the artifact (a changeset).
This is just the beginning, hence the Tech Preview in the title, what comes next is really exciting. Let’s sum it up, who will benefit from using Artidoc:
- Project Managers and Team Leads: Who need to ensure alignment between documentation and project execution.
- Product Owners and Designers: Who require a streamlined tool for writing specifications and seeing them seamlessly integrated with project tasks.
- Engineering Teams: That need to maintain traceability and manage detailed technical information within their projects.
- Compliance and QA Teams: Who benefit from structured documentation that supports traceability and version control.
Artidoc will be the bedrock of Tuleap Requirement Management later this year. We will improve editing capabilities, export options, document structure management, and coverage and traceability. Stay tuned!
Good bye RHEL & CentOS 7
RHEL and CentOS7 reach the End of Life at the end of June 2024, so does our support for these platforms. Tuleap 15.10 is the last version to provide packages for « el7 ». If not already done, you should upgrade to « el9 » (RHEL, Rocky, Alma) as soon as possible.
Bugs and requests
There were 36 bugs fixed and requests implemented during the 15.10 release cycle. Bugs and security fixes were already back-ported on Tuleap Enterprise builds. You will find below a detailed list of fixes. The most notable ones are in bold.
Security
- #38258 Anonymous should not see project members details
- #38297 Permissions of the backlog items are not verified – CVSSv3.1 score: 4.3 – Medium
Trackers
- #38286 Display of a computed field is done with a different precision depending on the area
- #38270 Adding a trigger should display an error message in case of issue
- #38259 ID confusion in query for bulk check of Artifact permissions
- #38253 Avoid multiple `/` at the end of user provided JIRA server URL
Backlog
- #38295 Ensure that at least some backlog items are loaded when displaying the page
- #38296 Optimize the retrieval of the « To be planned » items of an explicit backlog
Tuleap Functions
- #37947 Tuleap Functions execution details truncate output at 65536 chars
MediaWiki Standalone
- #35847 Management of session expiration
- #37585 External MediaWiki link to a PDF are mangled with the document icon
Git & Pull Requests
- #38274 Missing translation in Git commit details
OAuth2
- #38261 Allow the creation of OAuth2 app with a redirect endpoint to localhost
Project administration
- #38284 Do not allow end users to update project references created/managed by plugins
- #38271 Fix translation in icon selector
- #38299 Do not consider the Dynamic credentials user to be a technical user