update high level descriptions and document links