modify documentation according new architecture