improved the documentation according the new files