You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@ahaj@barkermi
Hey guys so awesome notebooks and now that it actually works, we can get into the nitty gritty of reviewing stuff.
First, the main problem is of course the setup which, we want to streamline this is being handled in Issue #24. Once I finish this script, I would like to run this with a fresh user to see how it works, and the tradeoffs of it. I would also like to hop in a call and discuss the end version of the script.
Before that there are 2 things that are relatively quick that can be solved.
There are times where I had to rename cells to make cells work, assuming these are resolved in the working version should be a simple push. If not I can help push a version of mine once all is renamed if that's needed. As mentioned if we can have this be userinput this could be ideal.
Code syntax: you guys did a really solid job of implementing standardized comment and code structure throughout.
Some comments need to better communicate the purpose of the code. Bad Comment example //Create a new object of the MyClass class MyClass obj = new MyClass(); Good Comment example // Instantiate a MyClass object to handle user data processing MyClass obj = new MyClass();
Explains the thing you are instantiating and the use for it.
A common comment I see is describing the function when the function name does this.
readfile(example.txt) #reads example.txt
this can be done without, cause ideally this is where our naming conventions make this easy to understand without the comments. We can make these changes overtime.
In terms of coding optimization those go into more detail so I'll make separate issues for those and will be much more guided. :)
The text was updated successfully, but these errors were encountered:
@ahaj @barkermi
Hey guys so awesome notebooks and now that it actually works, we can get into the nitty gritty of reviewing stuff.
First, the main problem is of course the setup which, we want to streamline this is being handled in Issue #24. Once I finish this script, I would like to run this with a fresh user to see how it works, and the tradeoffs of it. I would also like to hop in a call and discuss the end version of the script.
Before that there are 2 things that are relatively quick that can be solved.
There are times where I had to rename cells to make cells work, assuming these are resolved in the working version should be a simple push. If not I can help push a version of mine once all is renamed if that's needed. As mentioned if we can have this be userinput this could be ideal.
Code syntax: you guys did a really solid job of implementing standardized comment and code structure throughout.
Some comments need to better communicate the purpose of the code.
Bad Comment example
//Create a new object of the MyClass class MyClass obj = new MyClass();
Good Comment example
// Instantiate a MyClass object to handle user data processing MyClass obj = new MyClass();
Explains the thing you are instantiating and the use for it.
A common comment I see is describing the function when the function name does this.
readfile(example.txt) #reads example.txt
this can be done without, cause ideally this is where our naming conventions make this easy to understand without the comments. We can make these changes overtime.
In terms of coding optimization those go into more detail so I'll make separate issues for those and will be much more guided. :)
The text was updated successfully, but these errors were encountered: