Guidelines

Version  23.70

Date: 04.07.2023

AI | Narrate the ideas and convert your speech to a requirement

Useful when:

• You don’t have time to create or update documentation for your project

• You want to create comprehensive documentation for the tech team 

• You need to make sure that all aspects of the product requirement document are covered

• You are looking for a tool that provides an option to help junior specialists to write high-quality documentation

Guide:

First, you need to create a new requirement.

Once the requirement is created, click the ‘Narrator’ button on the ribbon.

The system will ask you to grant access to your microphone. You need to enable it only once by clicking the ‘Allow’ button. 

Once you enable it, the recording will start automatically without any other actions needed from your side. Just start narrating your thoughts. At first, it might be a bit awkward, but just give it a few tries until you get used to it. As soon as you record a few thoughts, you'll see how easy and convenient it is.

You can always discard recording by clicking ‘Cancel’ or simply closing the popup. To stop recording, you need to click the ‘Stop’ button.

When the recording is stopped, the aqua AI will be triggered to analyse what has been narrated and in a few seconds start generating the product requirement document. Your recorded audio is kept temprorary to generate a PRD and then removed once it's done.

Wait for a few seconds and then review the result. If you are happy with the created PRD, click the ‘Apply’ button.

The generated document will be automatically added to the description field of the requirement. You can easily extend or edit the created document. 

Moreover, aqua AI also adds the narrated notes as a ‘Background’ to the requirement, so you can always read what you have said, tweak it or extend it the text and then narrate it once again while reading the text, but already with the added details to create another version of PRD.

Last but not least, don’t forget to save a requirement to keep the document.

Besides, if you want to create a test case based on this requirement, click the ‘Copilot’ button. aqua AI will start analysing the document and create a test case based on it.

Note: aqua doesn’t store your recorded audios and they are kept for PRD generation only. When the requirement is generated and saved, the audio recording is deleted. 

AI | Saving context provided to the AI Copilot (test case generation) on a project level

Useful when:

• You have a complex or unique project with special terms that are essential for proper test case generation and you want to save this data

• You want to provide some additional data for AI Copilot to make test case generation more accurate and it’s permanent.

• You have many projects, but you want to preserve the provided data for test cases generation for each project individually and want aqua to save it.

Guide:

When you generated a test case, before quitting the popup, click on the ‘Expand’  button.

The section with the context will open.

Provide all information that you want aqua to store for further test case generation and either close the pop up or simply trigger the test case creation once again.

From now on, whenever you’ll start the AI Copilot, it will take the context into account.

In case you need to modify or update the background information, just substitute the previous data with the new one. AI Copilot will incorporate the recent information for future test case generations.

Jira | Improved flows for connecting Jira issues with aqua test executions and aqua items 

Useful when:

• You want to connect an already existing Jira issue to the test execution

• You want to create a Jira issue from aqua item and add it as a dependency

• You want to connect multiple Jira issues at once to aqua test execution or aqua items

Guide:

To connect existing Jira issues to aqua tickets, you need to set up the integration with Jira first. Follow this guide to get started in less than 5 minutes. 

Once the integration is in place, open the desired aqua item, navigate to the ‘Dependencies’ tab, and then click the ‘Connect Jira issue’ button.

When the popup opens, provide the IDs of the Jira issues (separated by commas) and then click the ‘Connect’ button. 

Please note, there is a limit of 10 IDs that you can provide at once. You will be able to link more items by going through the same steps again.