-
Notifications
You must be signed in to change notification settings - Fork 53
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
cEP5: Define bear picking strategy and ambiguity on configuration #78
Conversation
cEP-0005.md
Outdated
@@ -3,7 +3,7 @@ | |||
| Metadata | | | |||
| ------------ |-----------------------------------------------| | |||
| cEP | 5 | | |||
| Version | 2.0 | | |||
| Version | 2.1 | | |||
| Title | coala Configuration | | |||
| Authors | Lasse Schuirmann <[email protected]> | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Line contains following spacing inconsistencies:
- Trailing whitespaces.
SpaceConsistencyBear, severity NORMAL, section spacing
.
The issue can be fixed by applying the following patch:
--- a/cEP-0005.md
+++ b/cEP-0005.md
@@ -88,7 +88,7 @@
aspect name could be writen by its fullname (`Root.Redundancy.Clone`) or
partial name (`Redundancy.Clone` or even `Clone`) and are case insensitive.
Note that writing by partial name could result in ambiguity. Thus the desired
-aspect must be written by its fullname.
+aspect must be written by its fullname.
In case of multiple aspect has a same taste name, ambiguity will be resolved
by prefixing the taste name with its aspect name. For example, `max_length`
f91cded
to
b09dcbb
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The bear picking strategy should emit a log entry explaining the choice it made, and which bears were not used.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@adhikasp This is really nice :) Especially the prioritization! But there are some drawbacks in the texts...
cEP-0005.md
Outdated
@@ -85,6 +85,16 @@ files = **.(c|h) | |||
ignore_aspects = redundancy # Exclusive | |||
``` | |||
|
|||
aspect name could be writen by its fullname (`Root.Redundancy.Clone`) or | |||
partial name (`Redundancy.Clone` or even `Clone`) and are case insensitive. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- You start in singular (name, its) but end in plural (are)
- Instead of fullname better write fully qualified name
- Instead of partial name better write partially qualified name to avoid any misunderstandings
- Better use can instead of could
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sorry, grammar is never my best thing 😖
cEP-0005.md
Outdated
aspect name could be writen by its fullname (`Root.Redundancy.Clone`) or | ||
partial name (`Redundancy.Clone` or even `Clone`) and are case insensitive. | ||
Note that writing by partial name could result in ambiguity. Thus the desired | ||
aspect must be written by its fullname. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You don't need to necessarily use the fully qualified name in that case. It must only be enough qualified to remove the ambiguity
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Oh yeah, right
cEP-0005.md
Outdated
In case of multiple aspect has a same taste name, ambiguity will be resolved | ||
by prefixing the taste name with its aspect name. For example, `max_length` | ||
is a taste under `Shortlog` and `LineLength`. Thus defining the taste must | ||
be written by `Shortlog.max_length = 50`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- multiple aspects have ...
- is a taste of ...
- Thus the
Shortlog
taste would be defined like ...
Also, I agree with @jayvdb's #78 (review) |
Why we should tell which bears is not used, instead of just bear that is used? |
b09dcbb
to
fc91251
Compare
@adhikasp Perfect 🎉 We only have to wait for @Techievena to rebase #72 , so that you can then rebase on his merged commit And @jayvdb please approve as well :) |
@adhikasp According to what I've written in https://gitlab.com/coala/GSoC-2017/issues/139#note_31058470 : Let's maybe better not wait for @Techievena to rebase #72 ... Just to hurry up regarding GSoC |
cEP-0005.md
Outdated
@@ -3,7 +3,7 @@ | |||
| Metadata | | | |||
| ------------ |-----------------------------------------------| | |||
| cEP | 5 | | |||
| Version | 2.0 | | |||
| Version | 2.1 | | |||
| Title | coala Configuration | | |||
| Authors | Lasse Schuirmann <[email protected]> | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
add yourself as author
cEP-0005.md
Outdated
@@ -85,6 +85,18 @@ files = **.(c|h) | |||
ignore_aspects = redundancy # Exclusive | |||
``` | |||
|
|||
aspect name could be writen by its fully qualified name |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Per #69 (comment) and prior comments, the cEP should not be forced to use lowercase aspects
instead of using proper grammar, which is capitalised "Aspects" at the beginning of a sentence.
So, either use "Aspects" here, or adjust the sentence so that the word "aspects" is not the start of the sentence.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
fc91251
to
d637e1c
Compare
ack d637e1c |
@rultor merge |
@coala/aspects-developers