BS-2675, add more details on commandApi javadoc