README updated to reflect new class structure and known issues