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

Document how to write automated detector tests #69

Open
ProfJanetDavis opened this issue Jun 26, 2020 · 5 comments
Open

Document how to write automated detector tests #69

ProfJanetDavis opened this issue Jun 26, 2020 · 5 comments
Assignees
Labels
documentation Something needs to be documented

Comments

@ProfJanetDavis
Copy link
Contributor

There should be documentation of how to test a detector. Maybe this should go in or with the "how to write a detector" document. @j6k4m8 should weigh in on where this documentation belongs.

@ProfJanetDavis ProfJanetDavis added the documentation Something needs to be documented label Jun 26, 2020
@j6k4m8
Copy link
Member

j6k4m8 commented Jun 26, 2020

Agreed! In the tradition of test-driven development (which @neiljp expertly enforced in the early days of this repo, much to our benefit!) it probably makes sense for writing tests to be the backbone of that tutorial document. I'll add this to my stack :)

@j6k4m8
Copy link
Member

j6k4m8 commented Jun 26, 2020

Might also make sense for this doc to live in the wiki so that we can update it without a full PR/review process.

@ProfJanetDavis
Copy link
Contributor Author

@j6k4m8, we are on the same page about test-driven development!

Thanks for putting this on your stack. I'm taking the liberty of assigning this issue to you so that I remember.

@ProfJanetDavis
Copy link
Contributor Author

ProfJanetDavis commented Jun 26, 2020

And I like the idea of putting this documentation in the wiki so that it is easier to keep up to date. I did that with another project and I think it works pretty well.

The only reason I can think of to keep the developer docs in the code base would be if it helps remind contributors to update the docs when they update the code.

@ProfJanetDavis
Copy link
Contributor Author

ProfJanetDavis commented Jun 26, 2020

Hmmm, that makes me wonder if we should go a step beyond test-driven development to do doc-driven development - a time-honored tradition in my field of human-computer interaction.

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

No branches or pull requests

2 participants