User Tools
userguidesanddocumentation:release_flyers
Table of Contents
Release Flyers
The release flyers are created at the end of each sprint alongside the release notes.
The release flyers are designed to provide a more general overview of the sprint as opposed to the granular ticket-level view of the release notes.
As of IDMS 3.18, the release flyers are generated in the Errigal Doc Generation Repo project.
Steps To Prepare The Release Flyer
- This assumes the release notes are already completed. These are used as a reference for the release flyer content.
- Pull the latest version of the doc generation repo.
- Go to the inputs > Release-Flyers directory (file manager or via text editor; I use Typora)
- Under each customer folder, create a new directory for the current sprint (match existing naming conventions)
- In each of those folders, create the release flyer markdown file (match existing naming conventions)
- Copy over the layout of a previous release flyer, ensuring you copy the metadata at the top of the markdown file. This is what's needed to generate the flyer correctly.
- Update the content of the release flyer accordingly, using the release notes as reference.
Steps To Generate The Release Flyer
- Before you can send off the release flyer, you need to generate it in PDF form. Open the doc generator repo directory in the terminal.
- Run the command to generate a HTML version of the release flyer and output it to outputs > relevant_customer > Release-Flyers
- Here's some example code:
python3 generate-documents.py -g html -i inputs/Release-Flyers/ATC/Release-Flyer-IDMS-3.18/Release-Flyer-IDMS-3.18.md -o outputs/ATC/Release-Flyers
- Open the outputted html file in your browser.
- Right click on the screen and select Print.
- Select Save As PDF
- Set Margins to custom and set left, right, bottom margin to 0mm + set the top margin to 10mm.
- Ensure it looks visually correct then select Save.
- Do this for each customer's release flyer.
Submitting The Release Flyer
- Add the finished release flyers to the Sprint Management Folder under the relevant sprint Release Notes.
- Note This step might change in future sprints. We are planning to introduce Pull Requests to this process instead of manually moving the release notes + flyer to the drive for feedback.
userguidesanddocumentation/release_flyers.txt · Last modified: 2021/08/26 12:21 by 10.91.120.28