code refactor and comments

refactorizada una pequeña parte del código y añadidas cabeceras a las
funciones.