Sistemas informáticos

Appearance

Búsqueda de documentación ​

En informática es habitual encontrarse con tecnologías desconocidas, comandos que no recordamos, errores inesperados o configuraciones que necesitamos realizar por primera vez.

Por este motivo, una competencia fundamental de cualquier profesional informático es saber localizar, interpretar y verificar información técnica.

Actualmente, esta información puede obtenerse mediante diferentes medios:

  • herramientas de inteligencia artificial;
  • documentación oficial;
  • manuales y sistemas de ayuda;
  • buscadores;
  • repositorios de código;
  • foros y comunidades técnicas;
  • blogs, artículos y vídeos.

Las herramientas de inteligencia artificial han cambiado considerablemente la forma de acceder a esta información, ya que permiten realizar consultas directamente sobre un problema y trabajar no solo con texto, sino también con código, archivos, mensajes de error o capturas de pantalla.

Inteligencia artificial ​

Las herramientas de inteligencia artificial permiten realizar consultas utilizando lenguaje natural y obtener explicaciones adaptadas al problema que estamos intentando resolver.

Por ejemplo, podemos utilizarlas para:

  • consultar cómo realizar una determinada tarea;
  • obtener información sobre un comando;
  • interpretar un mensaje de error;
  • analizar una salida de terminal;
  • revisar un fragmento de código;
  • analizar una captura de pantalla;
  • comprender una ventana de configuración;
  • comparar diferentes alternativas;
  • localizar posibles causas de un problema;
  • obtener indicaciones para continuar un procedimiento.

Proporcionar contexto ​

La calidad de una respuesta depende en gran medida de la información proporcionada.

Una consulta como:

text
No funciona este comando.

aporta muy poca información.

En cambio, podemos proporcionar datos como:

  • qué queremos conseguir;
  • qué sistema operativo estamos utilizando;
  • qué versión utilizamos;
  • qué comando hemos ejecutado;
  • qué resultado esperábamos;
  • qué resultado hemos obtenido;
  • qué mensaje de error aparece.

Por ejemplo:

text
Estoy utilizando Ubuntu 24.04.

Quiero copiar el archivo informe.txt al directorio /opt/docs
utilizando la terminal.

Al ejecutar:

cp informe.txt /opt/docs

obtengo el error:

Permission denied

¿Por qué ocurre y cómo puedo solucionarlo?

Cuanto mejor sea el contexto proporcionado, más útil podrá ser la respuesta obtenida.

Utilización de capturas de pantalla ​

En muchas ocasiones resulta más sencillo mostrar directamente el problema.

Las herramientas de inteligencia artificial capaces de analizar imágenes permiten adjuntar, por ejemplo:

  • capturas de mensajes de error;
  • ventanas de configuración;
  • resultados mostrados por una aplicación;
  • salidas de terminal;
  • interfaces de administración;
  • fragmentos de código visibles en pantalla.

Una captura puede proporcionar información que sería difícil o lento describir manualmente.

Sin embargo, antes de adjuntar una imagen debemos comprobar que no contiene información privada o sensible, como contraseñas, claves, tokens, datos personales o información confidencial.

Proporciona contexto

Adjuntar una captura no impide añadir una explicación.

Indicar qué estabas intentando hacer, qué resultado esperabas y qué problema has encontrado facilita considerablemente el diagnóstico.

Código, comandos y errores ​

La inteligencia artificial resulta especialmente útil para analizar información técnica.

Podemos proporcionar directamente:

bash
sudo apt update

y preguntar qué hace el comando, o incluir un mensaje de error:

text
Permission denied

junto con una explicación del contexto en el que se ha producido.

También podemos proporcionar fragmentos de código y solicitar ayuda para comprender su funcionamiento o localizar un problema.

Esto permite mantener una conversación sobre el problema e ir proporcionando nueva información a medida que avanzamos en su resolución.

Documentación oficial ​

Aunque la inteligencia artificial permite acceder rápidamente a información técnica, la documentación oficial continúa siendo una fuente fundamental.

Es la documentación publicada y mantenida por los responsables de una tecnología, aplicación o proyecto.

Puede incluir:

  • instrucciones de instalación;
  • guías de utilización;
  • referencias de comandos;
  • documentación de APIs;
  • ejemplos;
  • requisitos;
  • notas sobre versiones;
  • procedimientos de configuración.

Durante el módulo utilizaremos, entre otras, documentación oficial de Ubuntu, Microsoft, Visual Studio Code, Git y GitHub.

La documentación oficial resulta especialmente importante cuando necesitamos:

  • confirmar la sintaxis exacta de un comando;
  • comprobar compatibilidad entre versiones;
  • conocer los requisitos de una aplicación;
  • consultar todas las opciones disponibles;
  • verificar que un procedimiento continúa siendo válido;
  • trabajar con configuraciones que puedan afectar a la seguridad o al sistema.

INFO

Una respuesta proporcionada por una inteligencia artificial puede ser correcta y útil, pero no constituye documentación oficial.

Cuando sea necesario garantizar la exactitud de una información, debemos contrastarla con la documentación correspondiente.

Manuales y ayuda integrada ​

Muchas herramientas incorporan sus propios mecanismos de ayuda.

En sistemas GNU/Linux, numerosos comandos disponen de páginas de manual que pueden consultarse mediante:

bash
man comando

Por ejemplo:

bash
man cp

También es habitual obtener una ayuda resumida mediante:

bash
comando --help

Por ejemplo:

bash
cp --help

Estas herramientas permiten consultar directamente la sintaxis, las opciones y el funcionamiento de los comandos sin necesidad de abandonar la terminal.

Buscadores y otras fuentes ​

Los buscadores continúan siendo útiles para localizar documentación, páginas oficiales y soluciones publicadas en Internet.

Una búsqueda técnica debería incluir términos suficientemente precisos.

Por ejemplo:

text
Ubuntu 24.04 file permissions chmod

será normalmente más útil que:

text
problema permisos

También podemos limitar una búsqueda a un determinado sitio web:

text
site:documentation.ubuntu.com file permissions

Además de los buscadores, podemos consultar:

  • repositorios de código;
  • foros especializados;
  • sistemas de preguntas y respuestas;
  • blogs técnicos;
  • artículos;
  • vídeos;
  • comunidades de desarrolladores.

Estas fuentes pueden contener información muy útil, pero debemos tener en cuenta su fecha, procedencia y versión de la tecnología utilizada.

Verificación de la información ​

Encontrar una posible solución no significa que debamos aplicarla inmediatamente.

Antes de utilizar una solución obtenida mediante inteligencia artificial, un buscador, un foro o cualquier otra fuente, debemos comprobar que corresponde a nuestro entorno.

Entre otros aspectos debemos revisar:

  • sistema operativo;
  • versión;
  • aplicación o tecnología utilizada;
  • requisitos previos;
  • fecha o vigencia de la información;
  • consecuencias de los comandos que vamos a ejecutar.

Una solución que era válida para una versión anterior de un sistema puede haber quedado obsoleta.

Comprobar antes de ejecutar ​

Debemos prestar especial atención a los comandos obtenidos de Internet o generados por una herramienta de inteligencia artificial.

Antes de ejecutar un comando debemos saber, al menos:

  1. Qué operación realiza.
  2. Sobre qué archivos, directorios o recursos actúa.
  3. Qué opciones se están utilizando.
  4. Si modifica o elimina información.
  5. Si requiere privilegios de administrador.

Comandos con privilegios

Debemos extremar las precauciones cuando un comando utiliza sudo o se ejecuta con privilegios de administrador.

No debemos ejecutar un comando únicamente porque una página web o una herramienta de inteligencia artificial nos indique que lo hagamos.

Resolución de un problema técnico ​

De forma general, podemos seguir el siguiente proceso:

  1. Identificar el problema o la tarea que queremos realizar.
  2. Recopilar la información disponible.
  3. Consultar las fuentes o herramientas adecuadas.
  4. Analizar la solución propuesta.
  5. Comprobar que corresponde a nuestro sistema y versión.
  6. Aplicar la solución.
  7. Verificar el resultado.
  8. Documentar el procedimiento cuando resulte necesario.

No siempre será necesario utilizar todas las fuentes disponibles. Una consulta a una herramienta de inteligencia artificial puede resolver rápidamente un problema sencillo, mientras que otras situaciones requerirán consultar documentación oficial o investigar diferentes fuentes.

Referencias utilizadas ​

Cuando para realizar una práctica sea necesario consultar documentación externa, se deberán indicar las fuentes utilizadas.

Para cada fuente será suficiente proporcionar su nombre y un enlace al recurso consultado.

Por ejemplo:

markdown
## Referencias

- [Ubuntu documentation](https://documentation.ubuntu.com/)
- [Git documentation](https://git-scm.com/doc)

Cuando una herramienta de inteligencia artificial nos haya conducido hasta una fuente técnica, se indicará como referencia la documentación finalmente utilizada para comprobar la información, no la conversación mantenida con la herramienta.

Durante el resto del módulo

La búsqueda de documentación técnica será una actividad transversal durante todo el módulo.

En las prácticas no se proporcionarán necesariamente todos los comandos o procedimientos necesarios. Parte del trabajo consistirá en localizar la información necesaria, comprobar que es adecuada para el entorno utilizado y aplicarla correctamente.