Uma sugestão seria migrar a documentação para a wiki do github para ficar mais organizado ao invés de misturada ao código