00:00:05We're very excited to announce the release
of Oxygen 27. This video will present some
00:00:11highlights of new features and updates
that were added in this version.
00:00:16A myriad of new features were implemented
for the AI Positron Assistant, which is
00:00:20an extra add-on that can be installed to
provide AI assistance. It now leverages
00:00:25a retrieval augmented generation process to
use information gathered from your project
00:00:29to make the AI's response more relevant.
In this example, we have an XML file with some
00:00:34basic instructions for creating a new draft.
After we click the Generate Documentation Draft button,
00:00:41 the AI retrieves information from the
project to generate a proposal for a draft.
00:00:47We'll click the "Generate document from
response" button and the AI creates a
00:00:51new document based on our instructions
and information from the project.
00:00:57Intelligent Agents is a new category of AI actions
designed to streamline DITA topic management.
00:01:03The Expand Draft action enhances a DITA topic by
using information gathered from related links and
00:01:08the current project via the retrieval augmented
generation process mentioned earlier.
00:01:14We can preview the proposed
changes before applying them.
00:01:19For our example of a ficticious interface mode,
00:01:22some minor cleanup will be required,
but it refined and expanded the topic
00:01:26to be similar to topics from our project
about other similar interface modes.
00:01:33Also in the Intelligent Agents category,
the Split Topic action can be used to
00:01:37split large DITA topics with numerous
subjects into multiple topic files.
00:01:43You can see that the AI generated
several new topics
00:01:47... and it modified the original file as well.
00:01:51Another Intelligent Agent, the Create Topics action generates DITA topics based on user input.
00:01:58We provided some simple instructions.
00:02:00It also retrieves relevant project
content to shape the response.
00:02:04The AI requests approval and we'll
confirm to continue the processing.
00:02:10And it generated several topics
based on our instructions and data
00:02:14retrieved from our project.
00:02:18Some new AI actions were also added for reusing DITA content.
For example, we'll find and select a note
00:02:24that we think might already have an existing
reusable component defined in our project.
00:02:29We'll use the "Reuse Component" AI action.
And the AI found a similar reused component
00:02:35and proposes to replace the note
with the reusable component.
00:02:47Another example in the Reuse category
is the Product Name action.
00:02:51It searches for product names in the content
and then the AI looks for any keys defined
00:02:55for the specific product names and
replaces them with key references.
00:03:06The Positron is now able to detect blocks
of XML code within the AI's response.
00:03:12We'll select the table in our sample document.
00:03:16And we'll give the AI instructions to
convert the table into a definition list.
00:03:22Notice that the AI's response contains
XML markers surrounding XML code.
00:03:29And we'll preview it to show that the Positron
is able to detect and insert the XML code.
00:03:39Some new development AI actions
were also implemented.
00:03:43For example, we'll use the Generate Code button to
have the AI propose code based on the instructions
00:03:49specified in our XSLT document.
00:03:57Another development example, the Suggest Refactoring action generates a suggestion for refactoring the selected code to simplify it
00:04:05or make it easier to read and understand.
00:04:16The diff tool also received some enhancements.
Within the directories comparison tool,
you can click the settings button,
00:04:25go to "Files Comparison"...
and there's an option there
00:04:29to "Ignore Nodes by XPath". We'll have it ignore
the id attribute of the concept element.
00:04:38And after re-performing the comparison, you
see that it now detects fewer differences
00:04:42since it ignored the nodes we specified.
00:04:48The quick fix support is now automated through the Apply all default quick fix proposals tool,
making it possible to apply all proposed quick
00:04:56fixes on one or more resources at once.
There are numerous ways to invoke the tool.
00:05:03We're invoking it from the DITA
Maps Manager in this example.
00:05:08In most cases, you can choose a scope ...
"Current DITA map hierarchy" in this instance.
00:05:15And it applies quick fix proposals
for all reported validation errors in the specified scope.
00:05:23The built-in Saxon processor
00:05:25used for XSLT and XQuery transformations and
debugging, has been updated to version 12.5.
00:05:32The new 12.5 engines are
available to choose from.
00:05:37And we'll invoke the content completion
in the XSLT file to show you that it
00:05:41includes the latest extension functions.
00:05:54An enhanced feature was added that enables you to transform JSON documents using XQuery processing.
00:06:01You see that there's a new JSON
transformation with XQuery scenario type.
00:06:07We'll select our XSLT file...
and apply the transformation. And in this case,
00:06:14it produced XML content in the Results pane.
The XQuery Builder view also now supports
00:06:25running the XQuery over JSON documents.
Notice there are 3 new Saxon 12.5 engines
00:06:31specifically for JSON. The builder view allows you
to compose complex XQuery expressions and execute
00:06:37them over the currently edited document.
00:06:40And you can see that it produced XML output in the Results view.
00:06:46These were just a handful of examples of the new features and enhancements that were implemented in Oxygen 27.
00:06:52For a complete list of all the additions,
see our what's new page on our website.