improve document structure and langs array readability