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

Trial Empirical Measurements: LB Solvers #17

Closed
smiths opened this issue Apr 2, 2020 · 5 comments
Closed

Trial Empirical Measurements: LB Solvers #17

smiths opened this issue Apr 2, 2020 · 5 comments
Assignees

Comments

@smiths
Copy link
Owner

smiths commented Apr 2, 2020

Measure 3 to 5 LB solvers using the empirical measures available in GitStats. You should use the same 3 to 5 solvers as for #15. Think about the story that the data tells. Which of the metrics are meaningful? Which ones should we continue to collect for other projects?

@peter-michalski
Copy link
Collaborator

peter-michalski commented Apr 19, 2020

Meaningful metrics not visible on GitHub:
Authors
Total files and Total lines (may also be used to gauge avg file size) - maintainability
Commits per day - maintainability

\
\
\

Comments on My 5 qualities (bold signifies measured using GitStats, italicized signifies measured with a different tool or found in the repo):

Robustness - measured through manipulation of the system, repo stats will not measure this.

Performance - measured through documentation, other measures will not be nicely comparable between solvers

Maintainability - open/closed issues, update frequency, number of maintainers, age, total size (lines of code), number of files, avg file size, number of modules, percentage of commented lines, quality of comments, quality of naming conventions,

Reusability - avg file size, modularization, documentation_/naming/commenting(are modules and interfaces defined)_, quality of comments

Portability - number of external files needed to be manually added, os platforms, os versions

The metrics that we will need another tool for: percentage of commented lines - this can be gathered using https://github.com/boyter/scc

@smiths
Copy link
Owner Author

smiths commented Apr 30, 2020

Thank you for your list @peter-michalski. I like your list. However, I'm not clear on how you are going to measure all of the italicized numbers. For instance, you mention quality of comments, and quality of naming conventions. Is there a tool to assess these?

The tool that you linked looks good. If we can get all of these measures from two tools, I think we'll be in good shape.

@peter-michalski
Copy link
Collaborator

@smiths unfortunately there is no tool for measuring quality of comments and quality of naming conventions. A score of some sort would have to be assigned by an expert after reviewing the repo.

I believe that we can get all required measurements using the two tools and information readily accessible in git repositories.

@peter-michalski
Copy link
Collaborator

I believe we have what we need from this issue and am closing it.

@smiths
Copy link
Owner Author

smiths commented May 19, 2020

Sounds good.

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

No branches or pull requests

2 participants