tutorial.md 3.6 KB

Que é iso?

Trátase dun modelo de repositorio de proxectos baseado na metodoloxía do proxecto Docart, que está en fase de desenvolvemento e propón unha documentación que inclúe, ademais dos rexistros de feito, a documentación obxectiva que se adoita facer, a documentación dos procesos os humanos están implicados nas decisións das persoas que colaboran en proxectos cidadáns, que ata hoxe quedaron fóra dos nosos rexistros. Un exemplo deste tipo de anotación é a documentación aplicada ao propio proxecto DocArt que se pode ver aquí: Documentación DocArt

É moi importante que cada proxecto de Colab estea rexistrado en Forxa, especialmente tendo en conta a fase de consolidación da iniciativa na cidade. Deste xeito, temos a colaboración de todos os directores para rexistrar os procesos de cada proxecto na Forxa. Ese modelo é unha suxestión de formato e tamén está aberto a críticas, suxestións e variacións.

Como funciona?

A filosofía de DocArt baséase na crenza de que é necesario incluír nos nosos rexistros algo que escapa ás anotacións tradicionais, xa sexa nas ciencias ou nos procesos de prototipado cidadá. Son as interaccións, os debuxos, as discusións, as decisións tomadas, os cambios de significado e ata un malentendido do equipo que se reflicte na dirección que leva o proxecto. O que moitas veces non é racional, que non máis que moitas veces, arroxámonos.

Entón, pensamos nun formato que inclúe 3 ​​partes:

- A receita rápida: é como un resumo executivo do proxecto, unha descrición obxectiva do que xa sabemos cando o propoñemos (nome, obxectivo, expectativas, público, implicado, etc.), aínda que chega ao final do proceso con algúns cambios; **

  • a receita lenta** - a mesma descrición obxectiva pero alongada, en detalle. Aquí engádense notas explicativas para ampliar a comprensión de quen está interesado en reproducir o prototipo ou o proxecto. Está organizado en "Antes", "Durante" e "Despois", onde os antes e despois xa teñen suxestións sobre o contido que se debería engadir eo "durante" ten un formato máis aberto para recibir un número infinito de notas. O conxunto de notas constrúe a receita lenta, que está sempre en proceso mentres o proxecto dure.

- o mapa de aprendizaxe - aquí é onde empezamos a innovar, incluídos os "hitos", momentos nos que, de forma colectiva, recoñecemos como a clave para avanzar nun problema e chegar ao receptáculo lento, momentos nos que se percibe. Os hitos tamén se poden entender como "ideas", pero sempre colectivas, compartidas polo grupo.

As notas e os grafemas

Importante tamén para a filosofía e documentación de DocArt están os conceptos de notas e grafemas. As notas son textuais, os grafemas son audiovisuais. Para tratar de incluír esa dimensión menos racional dos procesos, existen os grafemas. Son fotos, debuxos, garabatos ou ata audios e videos que aparecen unidos ao texto que rexistran os obxectivos obxectivamente. Os fitos están rexistrados, polo tanto, nunha nota

E que debo facer despois?

Suxerimos que os responsables da documentación dos proxectos de Colab pasen as anotacións dos seus procesos na plataforma Forxa para limpar, usando o esqueleto de documentación de DocArt. Dun paso a paso, sería:

  • fai un fork deste repositorio dentro do repositorio do teu proxecto;
  • edita cada sección coa información dos teus proxectos;
  • incluír fotos, dixitalizacións e información visual que formaron parte dos procesos de toma de decisións (post-its, sketches, scribbles) e que normalmente terminarían no lixo
  • Intente identificar algúns hitos do proxecto e inclui-los na documentación.