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

Data completeness subview class #15432

Open
wants to merge 8 commits into
base: master
Choose a base branch
from
Open

Conversation

ondenman
Copy link
Contributor

@ondenman ondenman commented Sep 2, 2016

Added class to provide data for data completeness subview:

screen shot 2016-09-02 at 12 30 12

Extracted from TermTable#percentages

@tmtmtmtm tmtmtmtm temporarily deployed to everypolitician-viewe-pr-15432 September 2, 2016 12:08 Inactive
@tmtmtmtm
Copy link
Contributor

tmtmtmtm commented Sep 2, 2016

Yardoc is complaining about:

[warn]: @param tag has unknown parameter name:  
    in file `lib/data_completeness.rb' near line 5

# The completeness of each type of member data as a percentage
class DataCompleteness
# @param [Array PersonCard]
def initialize(people:)
Copy link
Contributor

@tmtmtmtm tmtmtmtm Sep 2, 2016

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If this is receiving an array of PersonCard, perhaps better to call this something like person_cards. people would imply to me that it's wanting Person objects instead.

New name reflects that value is array of person cards.
New name reflects that completeness() is a query method
@tmtmtmtm tmtmtmtm temporarily deployed to everypolitician-viewe-pr-15432 September 2, 2016 14:12 Inactive
@tmtmtmtm tmtmtmtm temporarily deployed to everypolitician-viewe-pr-15432 September 2, 2016 14:13 Inactive
@tmtmtmtm
Copy link
Contributor

tmtmtmtm commented Sep 2, 2016

@ondenman You haven't fixed the problem yet that yardoc is complaining about at line 5 (i.e. you haven't documented what the variable is called — only its type)

end

CARDS = %i(social bio contacts identifiers).freeze
Percentages = Struct.new(*CARDS)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This Percentages class isn't documented…

@tmtmtmtm tmtmtmtm assigned ondenman and unassigned tmtmtmtm Sep 2, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants