Repository navigation
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.
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.
Please do not add a 'dot' at the end of the commit subject. Also, please be more specific about the build failure. Maybe a small snippet of the build error.
Why renaming fixes the build?
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.
Dots removed.
I do not know why we should go into why it is not building correctly - does it matter right now?
Function under define was not named correctly so it had to be renamed.
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.
@dabekjakub yes we really need to go into WHY we do changes. We need to develop good habits. Imagine if for such small changes we are not writing clear commit messages what are we going to do when we will have very complex design changes?!
So, please mention in the commit message why the build failed.
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.
@dbaluta what I mean mostly is that the change itself is self-explanatory.
The fact that the name of the function had to be changed in one place under a specific configuration clearly implies that it was defined differently in other parts of the code.
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.
Yes description usually should tell 'why', for bigger/unclear stuff you need at least paragraph, but for simple change simple sentence is enough. We need to find good balance between being overly obsessive and not-discouraging developers
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.
@dabekjakub
@dabekjakub would like to see this in the commit message. It just a one line explanation.
I'm insisting on this to create a good habit on documenting the commit messages. I understand that it seems obvious for you why the change is need but it doesn't hurt to add the explanation in the commit message.
For me it's not clear for example if the build fails with "multiple redefinition" of the same function or just actually function not defined.