new version of documentation; few fixes in workflows and code