Creación de funciones y documentación.

* Siempre debería incluirse documentación en las funciones,

por más sencillas y evidentes que sean.

* Típicamente deberíamos especificar los parámetros y el retorno.

Para cada función, usualmente queremos saber cuatro cosas.

1 ¿Cuál es su objetivo?

2 ¿Cómo se debe usar?

3 ¿Qué pasará cuando se use?

4 ¿Cómo deben usarse y qué representan los parámetros?