|
1 | | -# Project Title |
| 1 | +# Generate changelog with git-chglog |
2 | 2 |
|
3 | | -One Paragraph of project description goes here |
| 3 | +Github Action for creating a CHANGELOG.md file based on semver and conventional commits. |
4 | 4 |
|
5 | | -## Getting Started |
| 5 | +## Usage |
| 6 | +### Pre-requisites |
| 7 | +Create a workflow .yml file in your repositories .github/workflows directory. An example workflow is available below. For more information, reference the GitHub Help Documentation for Creating a workflow file. |
6 | 8 |
|
7 | | -These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system. |
| 9 | +Further more you need to have [git-chlog]() configured and have the configuration added to your git repository |
8 | 10 |
|
9 | | -### Prerequisites |
| 11 | +### Inputs |
| 12 | + - `next_version`: Next version number |
| 13 | + - `config_dir`: git-chglog configuration directory. Default: `.ghglog` |
| 14 | + - `filename`: Filename to write the changelog to. Default: `CHANGELOG.md` |
10 | 15 |
|
11 | | -What things you need to install the software and how to install them |
| 16 | +### Example workflow - upload a release asset |
| 17 | +On every `push` to `master` generate a CHANGELOG.md file. |
12 | 18 |
|
13 | | -``` |
14 | | -Give examples |
15 | | -``` |
16 | | - |
17 | | -### Installing |
18 | | - |
19 | | -A step by step series of examples that tell you how to get a development env running |
20 | | - |
21 | | -Say what the step will be |
22 | | - |
23 | | -``` |
24 | | -Give the example |
25 | | -``` |
26 | | - |
27 | | -And repeat |
28 | | - |
29 | | -``` |
30 | | -until finished |
31 | | -``` |
32 | | - |
33 | | -End with an example of getting some data out of the system or using it for a little demo |
34 | | - |
35 | | -## Running the tests |
36 | | - |
37 | | -Explain how to run the automated tests for this system |
38 | | - |
39 | | -### Break down into end to end tests |
40 | | - |
41 | | -Explain what these tests test and why |
42 | | - |
43 | | -``` |
44 | | -Give an example |
45 | | -``` |
46 | | - |
47 | | -### And coding style tests |
48 | | - |
49 | | -Explain what these tests test and why |
| 19 | +```yaml |
| 20 | +name: Build and release |
| 21 | +on: |
| 22 | + push: |
| 23 | + branches: |
| 24 | + - master |
| 25 | + pull_request: |
| 26 | + branches: |
| 27 | + - master |
50 | 28 |
|
| 29 | +jobs: |
| 30 | + package: |
| 31 | + runs-on: ubuntu-latest |
| 32 | + steps: |
| 33 | + |
| 34 | + with: |
| 35 | + next_version: "1.0.0" |
51 | 36 | ``` |
52 | | -Give an example |
53 | | -``` |
54 | | - |
55 | | -## Deployment |
56 | 37 |
|
57 | | -Add additional notes about how to deploy this on a live system |
58 | | - |
59 | | -## Built With |
60 | | - |
61 | | -* [Dropwizard](http://www.dropwizard.io/1.0.2/docs/) - The web framework used |
62 | | -* [Maven](https://maven.apache.org/) - Dependency Management |
63 | | -* [ROME](https://rometools.github.io/rome/) - Used to generate RSS Feeds |
| 38 | +## License |
| 39 | +The scripts and documentation in this project are released under the [MIT License](LICENSE) |
64 | 40 |
|
65 | 41 | ## Contributing |
66 | 42 |
|
67 | 43 | Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us. |
68 | 44 |
|
69 | 45 | ## Versioning |
70 | 46 |
|
71 | | -We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/nuuday/project/tags). |
| 47 | +We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/nuuday/github-changelog-action/tags). |
72 | 48 |
|
73 | 49 | ## Authors |
74 | 50 |
|
75 | | -* **Billie Thompson** - *Initial work* - [PurpleBooth](https://github.com/PurpleBooth) |
76 | | - |
77 | | -See also the list of [contributors](https://github.com/nuuday/project/contributors) who participated in this project. |
78 | | - |
79 | | -## License |
80 | | - |
81 | | -This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details |
82 | | - |
83 | | -## Acknowledgments |
| 51 | +* **Steffen F. Qvistgaard** - *Initial work* - [PurpleBooth](https://github.com/ssoerensen) |
84 | 52 |
|
85 | | -* Hat tip to anyone whose code was used |
86 | | -* Inspiration |
87 | | -* etc |
| 53 | +See also the list of [contributors](https://github.com/nuuday/github-changelog-action/contributors) who participated in this project. |
0 commit comments