improve doc strings, main system test and ABCs