Gestión del conocimiento

Vistas: 16357
0:00 / 0:00
Gestión del conocimiento

Esta semana parece que ha ido enfocada a mi lenguaje de marcado ligero favorito, hacia markdown. Sin embargo, tengo que decirte que es completa casualidad. En ambos podcast, he tratado temas que me atañen directamente, y en los que he encontrado en markdown un aliado para resolverlo. En este sentido, markdown es un viejo conocido, tanto del blog como del podcast. La cuestión, es que en este podcast, el tema surgió por el problema de la gestión del conocimiento. Es decir, como podemos transladar, o mas bien compartir, todo el conocimiento entre los diferentes miembros de un equipo. Al final, un equipo que deba actuar en determinadas situaciones, o resolver determinados problemas, debe actuar, con independencia de que cada uno de los miembros. Sin embargo, para nuestra desgracia, esto no siempre es así. Es mas, yo te diría que en muchas ocasiones, esto de que todos puedan actuar de igual forma, es muy extraño. Por esta razón es tan importante eso de la gestión del conocimiento.

La gestión del conocimiento

Gestión del conocimiento

¿En que ando metido?

Aplicaciones

En el caso de las aplicaciones, actualmente estoy trabajando en algunas imágenes docker, tal y como te contaré en este mismo episodio del podcast. Por supuesto, continuo con el reproductor de audio lplayer, para terminar con una nueva aplicación que se apoya en libpam-usb. Esta aplicación, que ya comenté en un artículo de hace tiempo, lo que te permite es no tener que poner tu usuario y contraseña en cada ocasión.

Artículos

Respecto a los artículos, he escrito dos artículos. Una sobre tratar archivos json en Bash, y un segundo artículo sobre redes en docker. Indicarte, que en el podcast, te hablo de que será sobre almacenamiento docker, pero al final, he preferido escribir sobre redes en Docker. Ya profundizaré sobre el tema del almacenamiento en Docker.

El problema de la gestión del conocimiento

Siguiendo con la temática del podcast de hoy, y una vez planteado el problema, de que no todos los miembros del equipo, normalmente, conocen todos los detalles del problema, hay que buscar una solución.

Así te puedes plantear algunas características para la solución,

  • que sea accesible a todos los miembros del equipo de forma que cualquiera pueda consultar, cualquiera pueda añadir contenido, que sea fácil de consultar.
  • otra característica que debemos requerir de la solución es que sea fácilmente editable. Aquí es precisamente donde entra a jugar markdown, dado que como lenguaje no tiene rival.
  • por supuesto, debe estar siempre y desde cualquier lugar accesible, para facilitar que cualquier persona del equipo pueda consultarlo, editarlo y modificarlo en cualquier situación

La solución

Desde mi punto de vista, y en base a la sencillez, la mejor solución que he encontrado hasta el momento de la combinación,

  • markdown. Mas que nada por la sencillez y los minimos recursos necesarios. Para editar o modificar un archivo de los pertenecientes a la gestión del conocimiento, solo necesitas un editor de texto plano.
  • git. Por supuesto, es necesario un control de versiones, que nos permita no solo gestionar la versión adecuada, sino además trabajar en equipo de forma realmente sencilla.
  • mkdocs. Un generador de sitio estático que te va a facilitar enormemente el trabajo, tanto individual como en equipo.

¿Que es mkdocs?¿Como te ayuda en la gestión del conocimiento?

Antes de continuar, indicarte que esta es mi apuesta, pero que si tu tienes otra solución, que me pueda ayudar, no dudes en contármela, que seguro que la probaré.

MKdocs es un generador de sitios estático, como te he comentado en la introducción. Ya te hablé sobre los generadores de páginas web estática, pero en este caso, le quiero dar un enfoque documental.

Se trata de un sistema sencillo, simple y potente. Y por supuesto, cada una de las páginas se puede escribir en markdown.

Y para que veas hasta donde llega la simplicidad, indicarte que la configuración del proyecto, se hace con un archivo.

¿Donde debe estar la gestión del conocimiento?

Puedes colocar todo el contenido de tu gestión del conocimiento en cualquier sitio. Desde sitios como GitLab con GitHub, a otros que controlas tu, como puede ser tu VPS o incluso una Rasbpberry.

Instalación

Puedes instalarlo directamente desde los repositorios, o bien utilizando pip3. Sin embargo, aprovechando el tutorial de docker, he decidido hacerlo con Docker. Así, la instalación, es tan sencilla, como ejecutar la siguiente instrucción en un terminal,

docker run -d --name mkdocs -p 80:8000 -v "$(pwd)"/docs:/srv/mkdocs atareao/mkdocs

Documentación

Aquí simplemente tienes que crear un directorio docs desde donde lances el contenedor.

Simplemente prueba y ya me cuentas…


Imagen de portada de Joao Tzanno en Unsplash

Ver el vídeo de este episodio
Transcripción

Mientras preparaba este podcast, el 126 y el podcast número 125, que los preparo los,

Dos conjuntamente, me he dado cuenta que la semana pasada la dirigí o estaba orientada,

O quedó orientada completamente hacia Docker y Docker Compose por diferentes razones. Y,

Esta semana ha quedado orientada completamente hacia Markdown. Y ha sido casualidad, de verdad,

Que no lo he preparado en absoluto, no es que esté haciendo semanas temáticas, sino,

Básicamente ha sido por necesidades, por necesidades propias. Así, necesidades propias como te contaba,

Esto de que estoy preparando los libros para aquellos que han donado a la página y posteriormente,

También para los suscriptores de la página. Y esta semana, o bueno, en este episodio del,

Podcast, te voy a hablar sobre el tema de la gestión del conocimiento. Algo que es realmente,

Importante y que muchas veces no le das la importancia que deberías darle. Y no le das,

La importancia que deberías darle porque básicamente te ves imbuido dentro de todo el proceso. Estás,

Agobiado por los plazos, por el tiempo y olvidas que una parte muy importante de tu trabajo,

De todo lo que hagas, tanto desde el punto de vista personal como desde el punto de vista,

Profesional, es documentarlo, documentarlo todo, contar todo lo que sucede. Y es que,

Efectivamente tenemos un verdadero problema con la gestión del conocimiento. En un equipo,

Pequeño, pues igual que en un equipo grande de gente que esté trabajando en un proyecto,

Determinado, uno de los grandes problemas es precisamente la gestión del conocimiento.

¿Por qué? Pues porque hay una persona del equipo que no cuenta al resto de personas lo,

Que está haciendo. Pero no se lo cuenta porque lo quiere ocultar, sino simplemente pues porque,

Las circunstancias, lo rápido que evolucionan las cosas, estás metido en el trabajo, pues no caes,

En que no se lo has contado. Y por esta razón, pues se pierde ese conocimiento porque la persona,

Que está en el proyecto sale, porque se va, porque deja de estar, por lo que las razones que sea. Así.

Creo que es fundamental que todo lo que es el conocimiento debe estar disponible para todos,

Pero no solamente debe estar accesible para todos, sino que también debe ser fácilmente,

Editable y siempre tiene que estar disponible. Así, te voy a contar una solución que tienes,

A tu alcance y que es muy sencilla de implementar, que combina, igual que hacía en el episodio anterior,

Del podcast, Markdown, Git y MKDocs.

Soy Lorenzo y esto es atareao.es. Este es el episodio número 126, un podcast sobre Linux, Ubuntu, Android y,

OpenSort. Aquí encontrarás desde cómo ser más productivo en el escritorio o montar un servidor,

De páginas web en un VPS, hasta cómo convertir tu casa en un hogar inteligente. Vamos, cualquier cosa,

Que quieres hacer con Linux, con gestión del conocimiento o sin él, seguro que la vas,

A encontrar aquí. Antes de nada, y como vengo haciendo todos los jueves últimamente, te,

Voy a contar en qué ando metido. En lo que se refiere a aplicaciones, por un lado estoy,

Muy metido con esto de hacer imágenes Docker de prácticamente cualquier cosa. Cada vez,

Que encuentro algo, pues hasta de una caja de zapatos hago una imagen Docker. Y las estoy,

Subiendo a Docker Hub para compartirlas, para que el que las quiera utilizar, pues las tenga,

Allí disponibles y no tenga que calentarse la cabeza de tener que hacer la imagen, simplemente,

Descargarla y utilizarla. Y luego, por el otro lado, sigo trabajando por supuesto en,

LPlayer. También tengo que darle las gracias a Yoyo Fernández porque hizo un vídeo de divulgación,

De LPlayer que es espectacular. Y vaya, lo decía porque estoy trabajando en LPlayer en actualizarlo,

Con todas las sugerencias que me habéis aportado. Y por otro lado, estoy trabajando en LibPan,

USB. LibPan USB es una librería que utilicé hace bastante tiempo que lo que te permite es utilizar,

Una memoria USB simplemente como llave. O sea, como llave, es decir, que tú no tengas que escribir,

En cada ocasión tus credenciales. Por ejemplo, cada vez que haces sudo, cada vez que quieres ganar,

Derechos de administrador, pues tienes que meter tus credenciales. Bueno, pues con esta solución,

Si tienes puesta la llave USB, no tienes que meter las credenciales, él reconoce que tienes,

La llave USB y ya está. Al final, la llave USB siempre la tienes metida en el... siempre,

La llevas contigo o es así. Pero no solamente podrías utilizar la llave USB, también puedes,

Utilizar el móvil. Si cuando estás con el ordenador, tienes el móvil conectado al ordenador,

Mediante un USB, mediante un cable USB, este lo puedes utilizar perfectamente como llave,

Por un lado se carga y por el otro lado no tienes que meter tus claves de administrador,

No está mal, ¿no? Bueno, en referencia a los artículos. Bueno, actualmente estoy,

Trabajando en dos artículos, que son los que vas a encontrar esta semana. Bueno, yo te,

Digo que estoy trabajando porque lo he escrito antes... o sea, todo esto lo está grabado antes,

De que haya terminado de escribirlo. ¿Vale? Entonces, el primero de los artículos es cómo,

Puedes tratar con JQ en Bash y el segundo de los artículos es el capítulo 10 del tutorial,

Sobre Docker, en el que voy a profundizar un poco más sobre el almacenamiento en Docker,

Me parece muy interesante y creo que todavía le puedo sacar un poquito más de punta de,

Lo que le saqué en el capítulo anterior. Todo esto sin meterme en grandes benjenades.

Esto es un... o sea, básicamente es un tutorial para que conozcas el uso de Docker, pero no,

Trato de hacer un tutorial de investigación ni mucho menos. Bueno, una vez ya te he contado,

Todo esto de qué ando metido y tal y cual, pues vamos al turrón, al turrón del capítulo,

De hoy, que es básicamente esto que te he hablado, sobre la gestión del conocimiento,

Cómo puedes hacer la gestión del conocimiento de una manera bastante sencilla. Una de las,

Cosas que más me han gustado hasta el momento de GitLab es la posibilidad que tienes de generar,

Wikis, de generar wikis que van en... que están realizadas en Markdown. Y esto me resulta muy,

Cómodo. Me resulta muy cómodo porque en un momento determinado puedes crear la documentación,

Sin tener que preocuparte, como te digo siempre, del estilo, de cómo lo haces, sino simplemente,

Te preocupas del contenido. Sin embargo, hasta el momento no he encontrado algo que sea,

Suficientemente ligero ni suficientemente cómodo para trabajar. Me refiero que sea parecido,

A GitLab. Y la solución que he encontrado es mkdocs, que es un proyecto cuyo objetivo es,

La documentación realizada en Markdown. Claro, todo esto si combinas Markdown, combinas mkdocs,

Que te digo, y combinas en GitLab, pues tienes una solución perfecta para el control de la,

Documentación. Igual que te conté en el episodio anterior del podcast en el que te hablé de cómo,

Puedes hacer un libro y cómo podías realizar un control de versiones sobre el libro, pues aquí,

Tendrías un control de versiones sobre la documentación de una manera muy sencilla. ¿Qué,

Es lo que te permite mkdocs? O mejor, ¿qué es mkdocs? Bueno, pues mkdocs es un generador de sitios,

Estáticos. Un generador de sitios estáticos tal y como el que te conté en el episodio número 120,

Recuerda que puedes encontrarlo en atareado.es barra podcast barra 120. ¿Qué te permite esto,

Bueno, pues básicamente lo que hace es convertir los archivos Markdown en archivos HTML de una manera,

Muy sencilla, con lo cual las puedes alojar en cualquier sitio. De hecho, GitLab te permite,

Hacer todo esto en integración continua. Quiero decir que tú simplemente subes tus archivos,

Markdown y él directamente los convierte a HTML y esto se ofrece directamente como una página,

De una web. Tal y como lo hice en el episodio 120, pero con Pelican. Pues aquí lo podrías hacer,

Con mkdocs. ¿Por qué me he cantado por mkdocs en vez de por Pelican? Pues no lo sé. Sinceramente,

Son tan buenos unos como el otro. Lo que sí que me gusta, por ejemplo, de mkdocs es que tiene,

Un formato muy sencillo de gestionar todo esto de la documentación y tiene un tema que se llama,

React the Docs, que seguro que te suena de mucho porque hay, o sea, te suena de mucho o no te suena,

Mucho porque lo puedes encontrar en muchas páginas web. Muchas páginas web de documentación,

Tienen ese formato de React the Docs que es tan reconocible. Vaya, pero básicamente es exactamente,

Lo mismo. Se trata de un generador de sitios estáticos muy potente, sencillo, las páginas,

Todas las páginas se escriben en Markdown y la configuración se escribe en YAML. ¿Qué ventajas,

Tiene esto? Bueno, la primera ventaja que le he encontrado es que es tan sencillo como que tú,

Por ejemplo, otra de las cosas que estoy haciendo es el libro o el tutorial sobre el terminal lo he,

Metido en un directorio, en un directorio donde se encuentran los 11 capítulos del tutorial. Esos,

11 Capítulos están en Markdown directamente. Yo cuando levanto el servidor de mkdocs directamente,

Lo que voy a encontrarme es eso en formato HTML. Voy a ver la página directamente y es súper cómodo.

Es súper cómodo. ¿Dónde puedes alojar mkdocs? Bueno, pues tal y como te lo he dicho, lo puedes,

Alojar en GitHub, en GitLab, en VPS, en tu VPS, en el que seas. Yo, por ejemplo, también tengo un VPS,

Donde tengo alojados algunos documentos realizados así con mkdocs y por supuesto también lo puedes,

Alojar en la Raspberry. ¿Para instalar? Bueno, para instalar solo necesitas Python. Python que puede ser 2,

Versión 2 o versión 3. Aunque tienes que recordar que la versión 2 de Python pues está disponible hasta,

Enero de 2020. Con lo cual lo suyo es que lo instales con Python 3. Y instalarlo con Python 3,

Pues es tan sencillo como pip3 install mkdocs. En fin, bueno, te lo dejo ahí en las notas del podcast,

Tú le pegas un vistazo y ya está. Sin embargo, para no complicarme la vida y llenarme el ordenador,

De porquería, que es lo que me suele suceder, que entre versión y versión de Ubuntu pasa esto,

Pues lo que he hecho ha sido un contenedor, un contenedor Docker que cuando lo levanto todas,

Las páginas que hay en un determinado directorio pues me las muestra como si fueran una página web,

Esto actualmente lo tengo alojado en una Raspberry, una Raspberry que tiene la ventaja de que también,

Me sirve como, vaya, tengo instalado el pvpn, de manera que puedo acceder en cualquier momento,

Desde cualquier sitio, a través de la vpn, puedo acceder a la Raspberry, puedo consultar,

Todos mis documentos. Así, configurarlo todo sería tan sencillo como, primero, editar el archivo,

YAML. A continuación de esto, podrías empezar a añadir páginas. Las páginas, si las añades,

Directamente sin ningún directorio, te van a aparecer en la página home y te aparecerán mucho,

Con lo cual yo te recomiendo que crees un directorio por cada subconjunto de páginas,

De manera que todas esas quedarán, digamos, accesibles desde el menú directamente.

Y eso es realmente muy sencillo. Y además te permite crear un nombre para el sitio y una,

Navegación que te lo haga todo bastante sencillo. Luego, por otro lado, lo que tiene que es muy,

Ventajoso, por así decirlo, es el tema de ponerle un tema. Valga la redundancia, ¿no? Se trata de poner un,

Tema que puedes poner, que viene por defecto, que a mí no me termina de gustar porque, no sé,

No lo encuentro atractivo y ponerle el tema que te he dicho, el tema de React de Docs y que queda,

Muy, pero que muy aparente. Por supuesto, le puedes cambiar el icono de manera que siempre te aparezca,

El pequeño icono en la pestaña y luego a partir de ahí ya puedes generar el sitio. Yo, mi intención,

En ningún momento es generar ningún sitio, sino simplemente es tener esa documentación disponible,

Para hacer lo que yo considere. Y hacer lo que yo considere básicamente es tener esa,

Documentación. ¿Por qué yo últimamente estoy muy empañado en todo esto de la gestión de conocimiento,

Y compartir la documentación con los compañeros de trabajo en particular? Bueno, pues el problema,

Que tenemos es que actualmente, pues, si te enfrentas a, digamos, a tratar de diferentes problemas,

Por cada uno de los integrantes de un equipo y cada uno lo resuelve de una manera concreta,

O siempre se enfrenta al mismo problema por, digamos, que una persona está encargada de,

Resolver un problema. Si esa persona un día no está o por lo que sea, porque se ha puesto,

Enfermo, porque se ha ido, por lo que sea, ¿quién resuelve ese problema? Entonces se trata,

De generar un documento o una lista de acciones a realizar, una lista de operaciones, una lista,

De actuaciones ante determinadas situaciones o cómo resolver un problema concreto. Y de,

Esta manera, pues, es muy sencillo. Es muy sencillo porque, primero, simplemente tienes que editar,

El archivo markdown donde está el trabajo que quieres realizar o resolver. Siguiente, una,

Vez lo tienes actualizado, creas una revisión en tu sistema de control de versiones, en,

Tu sistema git, y posteriormente, con un git push, lo subes a tu repositorio y de inmediato,

Ya tienes refrescada la información, refrescada y disponible para todos. Evidentemente, yo,

Le estoy poniendo la Raspberry, con lo cual va a estar para mí y para mi mujer, pero cualquiera,

Que tenga un pequeño equipo haciendo esta misma operación, pues lo tienes disponible para,

Todo el equipo. Y si todos trabajan sobre esta documentación, pues va enriqueciéndose,

Poco a poco y está disponible siempre para todos. Que básicamente era el objetivo que,

Trataba. Era buscar un sistema que permitiera que todo el mundo tuviera disponible la información,

Y que fuera fácilmente accesible. Y que cualquiera lo pudiera editar, cualquiera que tenga permisos,

Para editar ese repositorio, pues lo tiene ahí. Y básicamente era lo que te quería contar,

Era una cosa bastante sencilla. Como ves, es una manera de realizar la gestión de la,

Documental del conocimiento sin complicarte mucho la cabeza. Y básicamente al final es,

Lo que se trata, ¿no? Productividad y objetivo. En este sentido, decirte que, por supuesto,

He subido la imagen de Mechadocs para que esté disponible y la puedes utilizar fácilmente,

Está actualizada la versión de Python 3, con lo cual simplemente es hacerte un Docker,

Run con las instrucciones que te pongo en las notas del podcast y ponerte a trabajar,

Ya está. Poco más. En fin, espero que te haya gustado el podcast y que le saques productividad,

Al mismo. Recordate que puedes encontrar todo esto en las notas del podcast que es atareado.es,

Barra podcast barra 126. Pásate por allí y me dejas tu opinión, sugerencias, ideas o cualquier,

Cosa que se te quiera ocurrir o que se te pase por la mente. Recordarte que este es un podcast,

Suscrito a la red de podcast de Sospechosos Habituales, que te puedes suscribir a esa maravillosa,

Red de podcast en fitpress.me barra sospechosos habituales. Y como te digo siempre, recordarte,

Que la vida son dos días y uno ya ha pasado. Así que disfruta como si no hubiera mañana,

Y si puedes ser con Linux y gestionando tu conocimiento con Mechadocs, mejor que mejor,

Un saludo y nos escuchamos el próximo lunes.

¡Suscríbete al canal.

Deja una respuesta