Feature/1 initial version (#2)

* Initial version of files and project settings.

Co-authored-by: Saša Zejnilović <[email protected]>

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,25 @@
+---
+name: Bug report
+about: Create a report to help us improve
+labels: 'bug'
+
+---
+
+## Describe the bug
+A clear and concise description of what the bug is.
+
+## To Reproduce
+Steps to reproduce the behavior OR commands run:
+1. Go to '...'
+2. Click on '....'
+3. Enter value '...'
+4. See error
+
+## Expected behavior
+A clear and concise description of what you expected to happen.
+
+## Screenshots
+If applicable, add screenshots to help explain your problem.
+
+## Additional context
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,21 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+labels: 'enhancement'
+
+---
+
+## Background
+A clear and concise description of where the limitation lies.
+
+## Feature
+A description of the requested feature.
+
+## Example [Optional]
+A simple example if applicable.
+
+## Proposed Solution [Optional]
+Solution Ideas:
+1. 
+2. 
+3. 

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,13 @@
+---
+name: Question
+about: Ask a question
+labels: 'question'
+
+---
+
+## Background [Optional]
+A clear explanation of the reason for raising the question. 
+This gives us a better understanding of your use cases and how we might accommodate them.
+
+## Question
+A clear and concise inquiry

.github/ISSUE_TEMPLATE/spike_task.md

@@ -0,0 +1,36 @@
+---
+name: Spike
+about: Issue template for spikes, research and investigation tasks
+labels: 'spike'
+
+---
+
+## Background
+A clear and concise description of the problem or a topic we need to understand.
+
+Feel free to add information about why it's needed and what assumptions you have at the moment.
+
+## Questions To Answer
+
+1.
+2.
+3.
+
+## Desired Outcome
+
+The list of desired outcomes of this spike ticket.
+
+```[tasklist]
+### Tasks
+- [ ] Questions have been answered or we have a clearer idea of how to get to our goal
+- [ ] Discussion with the team
+- [ ] Documentation
+- [ ] Create recommendations and new implementation tickets
+- [ ] item here..
+```
+
+## Additional Info/Resources [Optional]
+
+1. 
+2. 
+3. 

.gitignore

@@ -0,0 +1,3 @@
+.idea
+target/
+node_modules

CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# How to Contribute?
+
+## **Identifying and Reporting Bugs**
+* **Ensure the bug has not already been reported** by searching our **[GitHub Issues](https://github.com/AbsaOSS/generate-release-notes/issues)**.
+* If you cannot find an open issue describing the problem, use the **Bug report** template to open a new one. Tag it with the **bug** label.
+
+## **Proposing New Features**
+
+* **Check if the feature has already been requested** by searching through our **[GitHub Issues](https://github.com/AbsaOSS/generate-release-notes/issues)**.
+* If the feature request doesn't exist, feel free to create a new one. Tag it with the **request** label.
+
+## **Contributing to Development**
+
+* Check _Issues_ logs for the desired feature or bug. Ensure that no one else is already working on it.
+    * If the feature/bug is not yet filed, please create a detailed issue first:
+        * **"Detail Your Idea or Issue"**
+* Fork the repository.
+* Begin coding. Feel free to ask questions and collaborate with us.
+    * Commit messages should reference the GitHub Issue and provide a concise description:
+        * **"#34 Implement Feature X"**
+    * Remember to include tests for your code.
+* Once done, push to your fork and submit a Pull Request to our `master` branch:
+    * Pull Request titles should begin with the GitHub Issue number:
+        * **"45 Implementing New Analytics Feature"**
+    * Ensure the Pull Request description clearly outlines your solution.
+    * Link your PR to the relevant _Issue_.
+
+### Community and Communication
+
+If you have any questions or need help, don't hesitate to reach out through our GitHub discussion section. We're here to help!
+
+#### Thanks!
+
+Your contributions are invaluable to us. Thank you for being part of the AbsaOSS community and helping us grow and improve!
+
+The AbsaOSS Team

README.md

@@ -1,2 +1,126 @@
-# generate-release-notes
-Efficiently automate your release note generation with 'generate-release-notes'. This tool scans your target GitHub repository's issues, sorting and organizing them into well-formatted release notes. Perfect for maintaining a streamlined and organized release process.
+# Generate Release Notes Action
+
+This GitHub Action automatically generates release notes for a given release tag by categorizing contributions into user-defined chapters based on labels. It streamlines the process of documenting new features, bug fixes, and breaking changes in your project releases.
+
+## Motivation
+
+Generate Release Notes action is dedicated to enhance the quality and organization of project documentation. Its primary purpose is to categorize release notes according to various labels, perfectly aligning with the unique organizational needs of each project. In addition, it offers robust support for acknowledging the efforts of contributors, thereby fostering a sense of recognition and appreciation within the team. Another noteworthy feature of this tool is its capability to detect potential gaps in documentation, ensuring that release notes are comprehensive and leave no stone unturned. Well maintained release notes are a vital component in maintaining high-quality, meticulously organized documentation, which is indispensable in the development process. This repository reflects our commitment to excellence in project documentation and team collaboration.
+
+## Setup and Usage
+
+### Prerequisites
+
+Before we begin, ensure you have a GitHub Token with permission to fetch repository data such as Issues and Pull Requests.
+
+### Adding the Action to Your Workflow
+
+Add the following step to your GitHub workflow:
+
+```yaml
+- name: Generate Release Notes
+  id: generate_release_notes
+  uses: AbsaOSS/[email protected]
+  with:
+    github_token: ${{ secrets.GITHUB_TOKEN }}
+    chapters: '[
+      {"title": "Breaking Changes 💥", "label": "breaking-change"},
+      {"title": "New Features 🎉", "label": "enhancement"},
+      {"title": "Bugfixes 🛠", "label": "bugfix"}
+    ]'
+    warnings: true
+
+- name: Print generated Release notes
+  run: |
+    echo "Generated Release Notes:"
+    echo "${{ steps.generate_release_notes.outputs.releaseNotes }}"
+```
+
+### Configure the Action
+Configure the action by customizing the following parameters based on your needs:
+
+- **github_token** (required): Your GitHub token for authentication. Store it as a secret and reference it in the workflow file as secrets.GITHUB_TOKEN.
+- **chapters** (required): A JSON string defining chapters and corresponding labels for categorization. Each chapter, like "Breaking Changes", "New Features", and "Bugfixes", should have a title and a label matching your GitHub issues and PRs.
+- **warnings** (optional): Set to true to enable warnings in the release notes. These warnings identify issues without release notes, without user-defined labels, or without associated pull requests, and PRs without linked issues. Defaults to false if not specified.
+
+### Build the Action:
+If you need to build the action locally:
+
+```bash
+npm install
+npm run build
+```
+
+Then, commit action.yml and dist/index.js to your repository.
+
+### Release Notes Extraction Process
+
+This action requires that your GitHub issues include comments with specific release notes. Here's how it works:
+
+#### Extraction Method
+The action scans through comments on each closed issue since the last release. It identifies comments that follow the specified format and extracts the content as part of the release notes.
+
+**Note**: The time considered for the previous release is based on its creation time. This means that the action will look for issues closed after the creation time of the most recent release to ensure that all relevant updates since that release are included.
+
+#### Comment Format
+For an issue's contributions to be included in the release notes, it must contain a comment starting with "Release Notes" followed by the note content. This comment is typically added by the contributors.
+```
+Release Notes
+- This update introduces a new caching mechanism that improves performance by 20%.
+```
+
+#### Contributors Mention
+Along with the release note content, the action also gathers a list of contributors for each issue. This includes issue assignees and authors of linked pull requests' commits, providing acknowledgment for their contributions in the release notes.
+
+#### Handling Multiple PRs
+If an issue is linked to multiple PRs, the action fetches and aggregates contributions from all linked PRs.
+
+#### No Release Notes Found
+If no valid "Release Notes" comment is found in an issue, it will be marked accordingly. This helps maintainers quickly identify which issues need attention for documentation.
+
+#### Warnings
+If the `warnings` option is enabled in the action's configuration, the release notes will include sections that highlight possible issues.
+
+The action includes four specific warning chapters to highlight potential areas of improvement in release documentation. Each chapter serves a distinct purpose:
+
+- **_Issues Without Pull Request_**
+  - **Purpose**: This chapter lists issues that have been closed since the last release but are not linked to any pull requests.
+  - **Importance**: Helps maintainers identify changes that might not have been properly reviewed or documented through PRs, ensuring the integrity of the release documentation.
+
+- **_Issues Without User-Defined Labels_**
+  - **Purpose**: Displays issues lacking the labels defined in the `chapters` configuration.
+  - **Importance**: Ensures all issues are categorized correctly according to the project's classification system. It aids in organizing release notes into predefined chapters effectively.
+
+- **_Issues Without Release Notes_**
+  - **Purpose**: Identifies issues that do not contain a "Release Notes" comment.
+  - **Importance**: Ensures that all significant changes are properly documented in the release notes, enhancing the completeness and usefulness of the release information provided to end-users.
+
+- **_PRs Without Linked Issue_**
+  - **Purpose**: Lists pull requests that are not associated with any issues.
+  - **Importance**: Encourages linking PRs to issues for better traceability and understanding of why changes were made. It also helps in maintaining a cohesive narrative in the project history and release notes.
+
+Each warning chapter acts as a quality check, ensuring that the release notes are comprehensive, well-organized, and meaningful. By addressing these warnings, project maintainers can significantly improve the clarity and effectiveness of their release documentation.
+
+
+### Contribution Guidelines
+
+We welcome contributions to the Generate Release Notes Action! Whether you're fixing bugs, improving documentation, or proposing new features, your help is appreciated.
+
+#### How to Contribute
+- **Submit Pull Requests**: Feel free to fork the repository, make changes, and submit a pull request. Please ensure your code adheres to the existing style and all tests pass.
+- **Report Issues**: If you encounter any bugs or issues, please report them via the repository's [Issues page](https://github.com/AbsaOSS/generate-release-notes/issues).
+- **Suggest Enhancements**: Have ideas on how to make this action better? Open an issue to suggest enhancements.
+
+Before contributing, please review our [contribution guidelines](https://github.com/AbsaOSS/generate-release-notes/blob/master/CONTRIBUTING.md) for more detailed information.
+
+### License Information
+
+This project is licensed under the Apache License 2.0. It is a liberal license that allows you great freedom in using, modifying, and distributing this software, while also providing an express grant of patent rights from contributors to users.
+
+For more details, see the [LICENSE](https://github.com/AbsaOSS/generate-release-notes/blob/master/LICENSE) file in the repository.
+
+### Contact or Support Information
+
+If you need help with using or contributing to Generate Release Notes Action, or if you have any questions or feedback, don't hesitate to reach out:
+
+- **Issue Tracker**: For technical issues or feature requests, use the [GitHub Issues page](https://github.com/AbsaOSS/generate-release-notes/issues).
+- **Discussion Forum**: For general questions and discussions, join our [GitHub Discussions forum](https://github.com/AbsaOSS/generate-release-notes/discussions).

action.yml

@@ -0,0 +1,18 @@
+name: 'Generate Release Notes'
+description: 'Automatically generates release notes for a given release tag, categorized into chapters based on labels.'
+inputs:
+  chapters:
+    description: 'JSON string defining chapters and corresponding labels for categorization.'
+    required: true
+  warnings:
+    description: 'Print warning chapters if true.'
+    required: false
+    default: 'false'
+
+branding:
+  icon: 'notebook'
+  color: 'yellow'
+
+runs:
+  using: 'node20'
+  main: 'dist/index.js'