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

Define default model for naming and commenting code #84

Open
alexandrebarbaruiva opened this issue Oct 3, 2017 · 7 comments
Open

Define default model for naming and commenting code #84

alexandrebarbaruiva opened this issue Oct 3, 2017 · 7 comments

Comments

@alexandrebarbaruiva
Copy link
Contributor

As you all know, as code complexity goes up, readability usually goes down. Therefore, it's vital that we unify our way of commenting and naming things

@alexandrebarbaruiva alexandrebarbaruiva changed the title Define default model for commenting code Define default model for naming and commenting code Oct 3, 2017
@alexandrebarbaruiva
Copy link
Contributor Author

I was looking at some code and it was quite hard for me to understand what it was that the code was doing, and since this repo has an intention of teaching/provide knowledge, I think it's fundamental that we make our code crystal clear to everybody!

@srbcheema1
Copy link
Owner

thanks for creating the issue 👍
similar issue was started by @sirjan13 in issue #63
this would be great to create some rules and measures to make the code readable and understandable

@srbcheema1
Copy link
Owner

@sirjan13 @alexandrebarbaruiva
lets first of all discuss on how this model should be .
also we will create a code_model.md for the contributers

@srbcheema1
Copy link
Owner

srbcheema1 commented Oct 3, 2017

i would also like to invite @Vehemos @achaJackson @aman935 to this issue :)

@alexandrebarbaruiva
Copy link
Contributor Author

I suggest that for every folder with program, there should have a readme with the name of the program and description (complexity, how it works, etc), this way we can have a deep understanding of all that happens in that particular folder

@srbcheema1
Copy link
Owner

@alexandrebarbaruiva
@sirjan13
i have added a CONTRINUTION.md file have a look at it .
also add more to it 😄

@Krishna-rudraksh70
Copy link

Hi,
I'm looking for issue to contribute to in Hacktoberfest. I noticed an issue in your repository regarding the "Define default model for naming and commenting code". I would like to request the opportunity to work on this issue.

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

No branches or pull requests

3 participants