Caravantes
22/05/21, 15:45:06
Hola.
Mientras estás haciendo una tarea tienes las ideas muy claras: sabes perfectamente cuál es el objetivo de la tarea, sabes para que sirve cada acción o bloque de acciones, sabes para qué sirve cada variable, etc.
Pero luego, meses o años después, puede que algunas de esas ideas ya no las recuerdes con claridad, especialmente si se trata de una tarea larga y compleja, con diferentes variables y distintas posibilidades (condiciones, bucles, etc). Y eso puede ser un problema cuando quieras revisar o mejorar algún detalle de la tarea.
Otros lenguajes de programación tienen opciones específicas para añadir comentarios en los que el programador escribe aclaraciones destinadas entender lo que hace el programa y cuáles son las finalidades de unos u otros detalles. Tasker no incluye ninguna opción específica para añadir comentarios, pero existe un truco para solventar esta carencia.
Todas las acciones de Tasker incluyen al final una opción para añadir una ETIQUETA. Aunque esa etiqueta se haya concebido como destino (u objetivo) de un salto (acción IR-A), podemos usar esa etiqueta para añadir un comentario. Me parece buena idea utilizar es etiqueta interna de una acción para añadir un comentario concreto sobre esa acción; por ejemplo para explicar el sentido de una variable, o el funcionamiento de una condición. A veces también se puede utilizar para añadir un comentario que no solo corresponde a esa acción individual, sino que el comentario afacta también a algunas otras acciones posteriores.
Además, Tasker incluye la "acción" ANCLA (Anchor, en inglés) que no hace nada y su único objetivo es precisamente insertar una ETIQUETA especialmente concebida como destino (u objetivo) de un salto (acción IR-A). Igualmente podemos usar esa etiqueta para añadir comentarios. Personalmente, utilizo esta posibilidad de la acción Ancla para añadir un comentario general al comienzo de la tarea, y a veces también en otros comentarios que afectan a un grupo importante de acciones, como explicar el funcionamiento de un bucle, por ejemplo.
En todos los casos, cuando tasker te muestra la tarea, la ETIQUETA (comentario) aparece justo antes de la propia acción que incluye esa etiqueta.
Todo esto es especialmente conveniente para tareas largas y complejas. Pero opino que es un buen hábito acostumbrarse a documentar y explicar todas las tareas, incluyendo las tareas iniciales que suelen ser pequeñas y sencilas. A veces ocurre que una tarea empieza siendo sencilla y con el tiempo le vas añadiendo más cosas y se acaba convirtiendo en una tarea compleja; por eso es preferible empezar a documentarla o explicarla desde que que empiezas a hacerla, incluso si es una tarea pequeña. Por otro lado, si adquieres este hábito incluso con las tareas pequeñas, luego ya te saldrá de forma natural cuando empieces a hacer tareas más ambiciosas.
Porsupuesto, puede haber personas con la cabeza bien amueblada y con buena memoria que no necesiten estas ayudas. Solo es una sugerencia desde mi experiencia y mi punto de vista. Y puede tener más importancia para tareas que vas a compartir con otras personas; por ejemplo, si las vas a publicar en un foro o en un repositorio de tareas para que otros internautas las puedan copiar o importar.
No he encontrado ninguna forma de comentar o documentar un perfil, salvo su propio nombre. [Edit: más abajo, en otro post, el compañero OSCONSE explica que se puede poner un comentario en las propiedades del perfil]
Añado tres capturas de pantalla de una tarea mía que tiene 52 acciones y 11 variables locales.
137437713743781374379
Se aceptan y agradecen opiniones, ideas alternativas, objeciones, etc.
P.D. Se me olvidaba comentar que las ETIQUETAS pueden añadir algo de código HTML. Por ejemplo,
<h1> significa "encabezado 1"; o sea que pone el texto a un tamaño mayor.
<font color=Green> significa que las letras deben estar en color verde.
13743801374381
Mientras estás haciendo una tarea tienes las ideas muy claras: sabes perfectamente cuál es el objetivo de la tarea, sabes para que sirve cada acción o bloque de acciones, sabes para qué sirve cada variable, etc.
Pero luego, meses o años después, puede que algunas de esas ideas ya no las recuerdes con claridad, especialmente si se trata de una tarea larga y compleja, con diferentes variables y distintas posibilidades (condiciones, bucles, etc). Y eso puede ser un problema cuando quieras revisar o mejorar algún detalle de la tarea.
Otros lenguajes de programación tienen opciones específicas para añadir comentarios en los que el programador escribe aclaraciones destinadas entender lo que hace el programa y cuáles son las finalidades de unos u otros detalles. Tasker no incluye ninguna opción específica para añadir comentarios, pero existe un truco para solventar esta carencia.
Todas las acciones de Tasker incluyen al final una opción para añadir una ETIQUETA. Aunque esa etiqueta se haya concebido como destino (u objetivo) de un salto (acción IR-A), podemos usar esa etiqueta para añadir un comentario. Me parece buena idea utilizar es etiqueta interna de una acción para añadir un comentario concreto sobre esa acción; por ejemplo para explicar el sentido de una variable, o el funcionamiento de una condición. A veces también se puede utilizar para añadir un comentario que no solo corresponde a esa acción individual, sino que el comentario afacta también a algunas otras acciones posteriores.
Además, Tasker incluye la "acción" ANCLA (Anchor, en inglés) que no hace nada y su único objetivo es precisamente insertar una ETIQUETA especialmente concebida como destino (u objetivo) de un salto (acción IR-A). Igualmente podemos usar esa etiqueta para añadir comentarios. Personalmente, utilizo esta posibilidad de la acción Ancla para añadir un comentario general al comienzo de la tarea, y a veces también en otros comentarios que afectan a un grupo importante de acciones, como explicar el funcionamiento de un bucle, por ejemplo.
En todos los casos, cuando tasker te muestra la tarea, la ETIQUETA (comentario) aparece justo antes de la propia acción que incluye esa etiqueta.
Todo esto es especialmente conveniente para tareas largas y complejas. Pero opino que es un buen hábito acostumbrarse a documentar y explicar todas las tareas, incluyendo las tareas iniciales que suelen ser pequeñas y sencilas. A veces ocurre que una tarea empieza siendo sencilla y con el tiempo le vas añadiendo más cosas y se acaba convirtiendo en una tarea compleja; por eso es preferible empezar a documentarla o explicarla desde que que empiezas a hacerla, incluso si es una tarea pequeña. Por otro lado, si adquieres este hábito incluso con las tareas pequeñas, luego ya te saldrá de forma natural cuando empieces a hacer tareas más ambiciosas.
Porsupuesto, puede haber personas con la cabeza bien amueblada y con buena memoria que no necesiten estas ayudas. Solo es una sugerencia desde mi experiencia y mi punto de vista. Y puede tener más importancia para tareas que vas a compartir con otras personas; por ejemplo, si las vas a publicar en un foro o en un repositorio de tareas para que otros internautas las puedan copiar o importar.
No he encontrado ninguna forma de comentar o documentar un perfil, salvo su propio nombre. [Edit: más abajo, en otro post, el compañero OSCONSE explica que se puede poner un comentario en las propiedades del perfil]
Añado tres capturas de pantalla de una tarea mía que tiene 52 acciones y 11 variables locales.
137437713743781374379
Se aceptan y agradecen opiniones, ideas alternativas, objeciones, etc.
P.D. Se me olvidaba comentar que las ETIQUETAS pueden añadir algo de código HTML. Por ejemplo,
<h1> significa "encabezado 1"; o sea que pone el texto a un tamaño mayor.
<font color=Green> significa que las letras deben estar en color verde.
13743801374381