Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve formatting for single contributor in release #9

Open
PaulRBerg opened this issue Dec 6, 2022 · 3 comments
Open

Improve formatting for single contributor in release #9

PaulRBerg opened this issue Dec 6, 2022 · 3 comments

Comments

@PaulRBerg
Copy link

I like Common Changelog a lot, but the format is a bit repetitive when all the references are authored by a single contributor. Here's an example from one of my open-source projects PRBTest:

Screenshot 2022-12-06 at 12 36 16 PM

It would be nice if the Common Changelog standard suggested a way to reference a contributor only once when appropriate, potentially underneath the release title or underneath each category:

## v0.2.0

All of the contributions below have been made by @paulrberg.

Or:

## v0.2.0

### Changed

All of the contributions below have been made authored by @paulrberg.

- Set cheatcode mutability/ visibility
- Split `Vm` in `Vm` and `VmSafe` interfaces

I know that the current standard recommends that:

If the project only has one contributor, author names can be omitted.

But there can be the situation (in fact, I would argue that this is the most common situation) when the project as whole as multiple contributors, but one particular release is handled by a single contributor.

What do you think?

@vweevers
Copy link
Owner

vweevers commented Dec 7, 2022

This is also common in my projects, but I don't mind the repetitiveness (anymore). Having author names in a consistent place makes a changelog easy to scan. In contrast, the "All of the contributions below ..." line has to be read in full in order to understand it. Putting it under the release title would conflict with notices which are intended for important notes only. We could perhaps introduce "footnotes" (i.e. arbitrary markdown content below the release) but it could invite misuse.

@PaulRBerg
Copy link
Author

Makes sense to me. I suggest we keep this issue open in case others will share their feedback in the future.

@bessman
Copy link

bessman commented Nov 1, 2023

I recently came across Common Changelog and have started using it in my own projects. Here's how I have been handling change authorship:

For projects which I own (i.e. they live under my github username), I never specify author unless a change was authored by someone other than myself. For such projects, the repo owner can be assumed to have authored any changes unless otherwise specified.

For projects owned by organizations (which typically have multiple significant contributors, especially over time), I always specify the author of every change, even if I am currently the only active maintainer.

If a project owned by an individual is transferred to an organization, that must be stated in the changelog. Any changes made prior to that point can be assumed to have been made by the original owner, unless otherwise specified.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants