# How are Changelogs generated

LightAct Changelogs are generated semi-automatically from LightAct 4 Jira project.

## Organisation of tickets

{% hint style="info" %}
Ticket is a generic term referring to a work item or a task in Jira.
{% endhint %}

### Epics

Our Development tickets are organized in Epics. Epics are a collection of tasks, for example:

* Flexible asset management for big shows
* Robust LightSync for 4.13
* Better timeline programming
* etc.

Our changelogs list all the Epics and in the Epics all the tickets that are part of it. At the end, it lists tickets that were not part of any Epic.

### Features, Improvements and Fixes

Tickets are categorized into 3 different types:

* **Features**: completely new functionalities
* **Improvements**: improved existing functionalities
* **Fixes**: fixes of existing functionalities

## Ticket data

### Ticket description

We use AI to convert a description of the ticket that's designed for development into something that, hopefully, is readable by you, our users.

For example, below is a description written by a human for a developer:

> "Can we add a simple node that triggers once when LightAct closes? Its name would be Run on Shutdown.
>
> The search keywords would also be: close, exit"

AI then transforms this into the following description for the changelog:

> Introducing "Run on Shutdown", a simple node that triggers once when LightAct closes. Keywords: close, exit.

As always with AI, sometimes it works great, but sometimes it's less than ideal.

### Additional Data

In the changelog we also show 2 additional pieces of information:

* **Status**: status of the tickets. If the release is a Beta release, some tickets might have a Testing status
* **Requesters**: we list 3 letter acronyms of the users that requested a specific upgrade. If no Requesters are listed, it means the ticket was designed by us.

## What's included in the Changelog

Not all tickets are included in the Changelog, but only those we deem to be of interest to our users.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lightact.com/release-changelogs/how-are-changelogs-generated.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.