search

chris-lovejoy / CodingForMedicine

A series of educational exercises, applying programming to medicine
21 stars 13 forks source link

Making breast_cancer_features exercise more interactive #5

Closed chris-lovejoy closed 1 year ago

chris-lovejoy commented 1 year ago

The breast cancer features exercise is only 'loosely' interactive. It encourages users to manipulate the code, but has no actual requirements for this and can run front-to-back without modification. Therefore, this exercise does not currently pass Principle 2 (of being interactive).

To improve it, there should be more explicit "stop points" where users are prompted to modify the code. For example, this could describe functions that could be used, but which aren't yet implemented - and invite the user to implement them and play around.

lawrenceadams commented 1 year ago

Dim question, what are the other Principles of being interactive?

Will modify my exercise to match

chris-lovejoy commented 1 year ago

So I added three principles to the README - interactive, highly descriptive and easy to run