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

angular: scope is missing from breaking changes #93

Closed
bekos opened this issue Aug 21, 2015 · 15 comments
Closed

angular: scope is missing from breaking changes #93

bekos opened this issue Aug 21, 2015 · 15 comments

Comments

@bekos
Copy link

bekos commented Aug 21, 2015

On angular preset, the generated breaking changes don't reference the scope for each change.
This should be the default behaviour IMO. Thx.

@stevemao
Copy link
Member

I don't understand. Can you elaborate?

@bekos
Copy link
Author

bekos commented Aug 22, 2015

Sure. You can see here what I mean.

If a commit message is like:

fix(ngAnimate): ....

Breaking chnage: due to .....

I expect on Breaking Changes section, inside the CHANGELOG.md, the ngAnimate to be referenced, like:

BREAKING CHANGES: 

* ngAnimate: due to ...

and not just

BREAKING CHANGES: 

* due to ...

like it is happening now.

@stevemao
Copy link
Member

This is defined by the angular project. Only if your "type" is feat, fix or perf it will appear in the changelog. If you think this is not correct, you should probably open an issue there.
Or use the angular preset and change the settings to your needs.

@bekos
Copy link
Author

bekos commented Aug 22, 2015

I referring only to the Breaking Changes section, not the Bug fixes or the Features. On the Breaking changes section, for each breaking change there is not reference to the <scope> of the commit.

@pkozlowski-opensource
Copy link

@bekos are you saying that breaking changes should be added regardless of the type of change, that is - also for refactor in this case?

I would argue that other types of changes (refactor, docs, tests) shouldn't actually contain breaking changes. Otherwise it is more than just a refectoring.... Just my $0.03....

@bekos
Copy link
Author

bekos commented Aug 22, 2015

@pkozlowski-opensource Nope.

I'm just telling that the <scope> of the commit message, ie ngAnimate is not referenced in the generated Breaking changes section. Just look at my example above :-)

@stevemao
Copy link
Member

I see what you mean now. I don't think angular projects are doing this. You can modify the template to achieve this.

@bekos
Copy link
Author

bekos commented Aug 23, 2015

For Angular 1.x this is the way they used to do this and are still doing it. Angular 2.x is not, but I think this is a problem, because if you forget to explicitly repeat the <scope> of the commit, in the text of the breaking change, it can be very confusing.

I argue about the default usage, but if this is something I can easily override on my side, through the templates, Im fine with it :-)

@bekos bekos closed this as completed Aug 23, 2015
@stevemao
Copy link
Member

@pkozlowski-opensource is it the expected behaviour? The template for the presets can be changed.

@stevemao
Copy link
Member

@bekos @pkozlowski-opensource I think it was modified so that they don't care about the scope in the breaking changes any more? Or we just forgot it?

@bekos
Copy link
Author

bekos commented Aug 25, 2015

My opinion is that without scope you lose the context, and you cannot easily find out if the breaking change affects you.

@oupala
Copy link
Contributor

oupala commented Nov 13, 2015

scope of breaking change does now appear in the changelog, but it is not in bold as it should be.

Scopes are in bold in the changelog, except in the breaking change. I think this is a bug. Isn't it?

@stevemao
Copy link
Member

Angular team didn't give me the requirement on this. So this whole issue wasn't a bug. I just thought it made sense to add them. I don't know what format it should be.

@oupala
Copy link
Contributor

oupala commented Nov 16, 2015

As you include the scope in the breaking change, I thought it would be more consistent that scope would always be in bold, in bugfixes, features and in breaking change. Don't you think ?

@stevemao
Copy link
Member

@oupala PR welcome :) I don't know what the angular team whats so I don't have any thoughts.

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

No branches or pull requests

4 participants