In DrWhy2/DrWhy: Explain, Explore and Debug Predictive Machine Learning Models

I simply love the tidyverse manifesto written by Hadley Wickham.

Especially one point, that I believe is a key differentiator between DrWhy tools and many other tools for XAI.

Design for humans

Copied from tidyverse manifesto

Design your API primarily so that it is easy to use by humans. Computer efficiency is a secondary concern because the bottleneck in most data analysis is thinking time, not computing time.

• Invest time in naming your functions. Evocative function names make your API easier to use and remember.

• Favour explicit, lengthy names, over short, implicit, names. Save the shortest names for the most important operations.

• Think about how autocomplete can also make an API that's easy to write. Make sure that function families are identified by a common prefix, not a common suffix. This makes autocomplete more helpful, as you can jog your memory with the prompts. For smaller packages, this may mean that every function has a common prefix (e.g. stringr, xml2, rvest).

DrWhy2/DrWhy documentation built on Feb. 23, 2023, 2:57 p.m.