Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.
Sign upCode styling seems inconsistent? #5075
Comments
This comment has been minimized.
This comment has been minimized.
It looks like it hasn't hit a release yet, but But regarding the question - the code styling seems inconsistent because it is inconsistent. |
This comment has been minimized.
This comment has been minimized.
Thanks, @pameyer , yes I was going to point out that your pull request #4995 helped explain about our preferred curly brace placement. It's been merged already and can be seen here for now: http://guides.dataverse.org/en/4990-ec2-ansible-scripting/developers/coding-style.html#braces-placement |
This comment has been minimized.
This comment has been minimized.
@poikilotherm thanks for pull request #5094! I'll move it to code review at "Community Dev" at https://waffle.io/IQSS/dataverse but like you said in the pull request we probably won't want to merge it exactly as is so there's a good chance we'll send it back to you with questions or create our own config based on what you've demonstrated in the pull request. |
pdurbin
added
the
Status: Code Review
label
Sep 25, 2018
This comment has been minimized.
This comment has been minimized.
IMHO you should cover as many aspects as possible... The sooner you get a consistent styling and the sooner you get people to document the code they are writting the better. But that's just my 2 cents. |
scolapasta
assigned
pdurbin
Sep 26, 2018
added a commit
that referenced
this issue
Sep 27, 2018
pdurbin
referenced this issue
Sep 27, 2018
Merged
add checkstyle (no tabs, left curly) and usage docs #5075 #5106
This comment has been minimized.
This comment has been minimized.
@poikilotherm I think what we need is more of a baby step at this point so I just closed your pull request #5094 in favor of pull request #5106 which is smaller in scope and doesn't fail the build. Code review from all is welcome! |
poikilotherm commentedSep 21, 2018
Dear all,
currently being active working on patches and stuff, I wondered about the style conventions you guys use and how I should write my code to be in line with your code of conduct. Example: indentation. I just found http://guides.dataverse.org/en/latest/developers/coding-style.html, which is not very precise/elaborated on that.
I would really enjoy something more sophisticated (like how you would like to see braces been set, etc)...
Also, there seem to be issues with different settings from different developers. An example from my IDEA IDE, showing the Maven
pom.xml
:But I also saw indentation hell in some Java code files...
Maybe some tooling could help with this? E.g. CheckStyle, which can be configured as needed, starting with indentation and maybe add more stuff down the road? This is also available as simple to use Maven plugin...