docs(1298): close the discoverability gaps found in the v1.4.0 review (#1310)