Estructurando el flujo documental y livecodeando.

Presentación del diplomado
- Índice, para encontrar las otras sesiones

Asistentes

Offray
viviana
constanza
choff
Víctor
Sara del Mar
Caos
ruidajo

Agenda:

Empalme.
Live Coding.
El código como material “recalcitrante” (Sam Aaron).
Automatizando los primeros flujos documentales.

Empalme

Preguntas

¿Cuál es la diferencia escencial entre la documentación en distintos sistemas que hemos visto (Glamorous, HedgeDoc, TidlyWiki)?

No.	Características	HedgeDoc	TiddlyWiki	Grafoscopio/GToolkit	mdBook
01	Formato	Markdown	WikiText / Markdown parcial	Markdown / Markdeep	Markdown
02	Colaboración	Síncrona	Asíncrona	Asíncrona	Asíncrona
03	Documentos computacionales	No	Parcial	Sí	No
04	Lenguaje de Programación	JavaScript	JavaScript	Pharo	Rust
05	Macros	Parcial	Sí	Sí	Parcial
06	Lenguajes de dominio específico (DSL)	Pobre	Rico	Rico	Parcial (plugins)
07	Transportabilidad del DSL	nula	Baja	Alta	baja
08	Búsqueda	Genérica	Detallada	Detallada	Detallada
09	Transclusión	No	Si	Sí	Sí
10	Plataforma	Web	Web	Escritorio	Web
11	Tipo de plataforma	MPA	SPA	MPA	MPA

Convenciones:

MPA: Multi Page Application.
SPA: Single Page Applicacion

Responde a preguntas de contexto como:

¿Quiero hacer un taller y editar simultaneamente? (HedgeDoc)
¿Quiero tener una plataforma web de visualización de información y documentacion modular (rompecabezas) y estructurada emergente? (TiddlyWiki)
¿Quiero tener una herramienta extensible con la documentación en mi escritorio y con posibilidades multiples de exportación y capacidades computacionales? (SmallTalk - Pharo - Gtoolkit - Grafoscopio/MiniDocs)

¿Cuál es la línea de tiempo, en qué momento fue evidente la necesidad de pasar de TWiki a Glamorous?

¿Es Markdown un estándar?

Es un estándar de facto. pero esta pobremente establecido.

Markdown fue creado en ~2004 por Jhon Gruber y Aaron Swartz, estudiando las convenciones ad-hoc de escritura de correos. El formato fue específicado en una implementación markdown.pl. El creador de Stack Overflow, Joel Spolsky, tuvo una pelea Gruber alrededor de lo que el primero “paternidad responsable” de los proyectos de software libre. De esta pelea y la intensión de no participar en nada con Joel surgió Common Mark, del cual particpa Jhon McFarlene, creador Pandoc. Propuso finalmente un nuevo formato, llamado Djot, nacido del ensayo Beyond Markdown.

Un formato interesante y fácil de aprender, extensible es AsciiDoc. Para más diatribas, pueden ver Mi lenguaje de etiquetamiento ideal

Comic de xkcd sobre standards id:927

Comic de xkcd sobre standards id:927 https://xkcd.com/927/

Un lugar donde las reflexiones entre plataformas de publicación, su interconexión y valor diferencial pueden ser apreciadas es la Documentatón.

Live Coding

Ver

Luego del video vamos a ir a este enlace

https://flok.cc/s/grafoscopicos
- https://foxdot.org/
- https://hydra.ojack.xyz/docs/

Usualmente las comunidades de livecoding se reunen u organizan en Toplap.

En la comunidad hemos hecho datarodas enfocadas en livecoding sonoro o visual:

El código como material “recalcitrante” (Sam Aaron).

El creador de Sonic Pi, Sam Aaron en un artículo académico, habla del código como material recalcitrante, con su propia lógica, que se opone a determinadas manipulaciones y facilita otras.

Lo explicaremos con un video:

Pausa Chilaquilera

Foto de seis platos de chilaquiles, mogollas con guacamole, vasos para mimosas y café

Automatizando los primeros flujos documentales

En nuestra sesión previa consideramos este flujo de trabajo

Gráfica con el flujo entre el sistema operativo, grafoscopio y la web

Vamos a adentrarnos en el ecosistema de Smalltalk.

Gráfica mostrando la relación entre el sistema smalltalk y el sistema operativo

Iremos enriqueciendo y modificando la imagen, en la medida en que la usamos.

El documento exportado la última vez, entonces, hace parte de la imagen. Si queremos exportarlo al sistema de archivos, debemos cliquear el botón a continuación para hacerlo: