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

Create template to render readme and docs #25

Closed
ejm714 opened this issue Aug 17, 2018 · 1 comment
Closed

Create template to render readme and docs #25

ejm714 opened this issue Aug 17, 2018 · 1 comment
Assignees
Labels

Comments

@ejm714
Copy link
Contributor

ejm714 commented Aug 17, 2018

Want to programmatically generate them so they both get updated when checklist or references are updated.

@ejm714 ejm714 added the docs label Aug 17, 2018
@pjbull pjbull self-assigned this Aug 20, 2018
@pjbull
Copy link
Member

pjbull commented Aug 21, 2018

Add to framing:

  • Pithy, actionable

  • Not all have to be relevant to every project (N/A is an ok answer)

  • It is ethical to be good at your job, but this is not a list of statistical best practices

  • Provoke discussion, not recommending particular fixes or policies

  • Don't create comprehensive lists of what is unfair or harmful, this is up to the teams that use the checklist

  • Have we noted where we are vulnerable to bias from missing perspectives?

  • The list follows the data science process and not all projects engage all the steps, so may not be relevant

  • ethics is hard, so these conversations may also be hard

  • Submit PR as a way to get the convo started (references give some ammunition)

Add to contributing:

  • changes to references for those tables

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

No branches or pull requests

2 participants