responsive api design (readme driven) of the disambiguation library