DocuWiki de la CIAA con code inyection

[Eric Pernia]

Buenos dias, encontré esto hoy en la wiki del proyecto CIAA:

En: http://www.proyecto-ciaa.com.ar/devwiki/doku.php?id=desarrollo:edu-ciaa:edu-ciaa-nxp:ada:instalacion_windows&s[]=zadig

Le agregaron toda una seccion de instalacion de esto a ese archivo:

Descargar e Instalar GNAT GPL 2017

Que obviamente no usamos nosotros.

Vengo pensando en dar de baja la Wiki y pasar a otro sistema como páginas de github o algo similar. Además tenemos mucha info desactualizada.

La dokuwiki tiene muchas vulnerabilidades. Prefiero generar HTML estático de alguna otra manera.

¿Qué opinan?

Abrazos.

Eric.

[martin ribelotta]

En realidad el que puso las cosas de gnat es el usuario mmarcos, que
no se quien será pero fue quien creo la pagina.

En todo caso, estoy de acuerdo en movernos a algo como github o
gitlab... pero seguir en wiki... va, es debatible... pero el asunto de
generar la pagina es bastante molesto... yo buscaría algo mas "on the
fly"...

La ventaja de usar wikis de gitlab/github es que podemos tener
colaboradores distribuidos y aceptar los cambios o pedir
modificaciones a esos cambios de una forma mas controlada...

Que opinan? Yo apoyo lo de mover la wiki de lo que esta ahora a github
y la pagina, bueno... tener algo que permita que un usuario normal la
navegue... porque lo que tenemos como pagina ppal ahora, esta bueno
para mostrárselo a funcionarios del gobierno... pero da un poquito de
pena para la gente de andar a pie...

El mié., 24 abr. 2019 a las 11:21, Eric Pernia
(<ericp...@gmail.com>) escribió:

[Carlos Pantelides]

Hola

La wiki actual permite algunas cosas interesantes como composición, pero no ha prendido, sólo la he usado yo.

github estaría muy bien, nos despreocupamos del hosting, de seguridad, actualizaciones, el versionado (jeje) y si hiciera falta migrar es muy sencillo

pero no olviden que la landing page actual, lo que armó con tanta paciencia Ariel tiene que subsistir

--

--
Carlos Pantelides
@dev4sec
https://github.com/cpantel
https://seguridad-agile.blogspot.com/

[Marcos Hernán García]

Buenos dias,

                    me parecio de interes la conversacion y me sumo con una sugerencia que les puede servir. Existen varias herramientas de este estilo, pero la que conozco y se usa en muchos sitios es MkDocs. Te soluciona automaticamente todo lo que es el layout de la documentacion y se escribe todo en Markdown. Y a partir de eso te genera automaticamente todo los html y css estaticos para subirlo donde quieras. Inclusive hay formas sencillas de subirlos a las wikis de GitHub, Gitlab, etc.

https://www.mkdocs.org/

Lo tiro por si no lo conocian y capaz le soluciona bastante de las problematicas en lo que respecta a la documentacion. Es muy facil de usar. Lo bueno es que si lo quieren versionar solo necesitan versionar los Markdown. Y no el resto de la basura.

Saludos,

Marcos

--
Has recibido este mensaje porque estás suscrito al grupo "CIAA-Hardware" de Grupos de Google.
Para cancelar la suscripción a este grupo y dejar de recibir sus mensajes, envía un correo electrónico a ciaa-hardwar...@googlegroups.com.
Para acceder a más opciones, visita https://groups.google.com/d/optout.

[martin ribelotta]

El mié., 24 abr. 2019 a las 12:19, Carlos Pantelides
(<carlos.p...@gmail.com>) escribió:
>

> Hola
>
> La wiki actual permite algunas cosas interesantes como composición, pero no ha prendido, sólo la he usado yo.
>
> github estaría muy bien, nos despreocupamos del hosting, de seguridad, actualizaciones, el versionado (jeje) y si hiciera falta migrar es muy sencillo
>
> pero no olviden que la landing page actual, lo que armó con tanta paciencia Ariel tiene que subsistir
>

No digo eso... solo que hay un publico que esa pagina no le es util...
en especial gente de afuera que no esta acostumbrada a ese estilo de
paginas.

Por eso, armar algo en la wiki de github o incluso una pagina mas
técnica usando las paginas de <nombreproyecto>.github.io nos daría
mucho mas control y seria mas colaborativo... ademas de poder vertir
todo el contenido técnico sin tener que estar pensando en una landing
page como la que armo ariel... que esta perfecta, pero repito, para el
target de los técnicos es un poco sosa ya que no esta fácil de
encontrar la información mas técnica.

[martin ribelotta]

El mié., 24 abr. 2019 a las 12:25, Marcos Hernán García
(<marcos....@gmail.com>) escribió:

>
> Buenos dias,
>
> me parecio de interes la conversacion y me sumo con una sugerencia que les puede servir. Existen varias herramientas de este estilo, pero la que conozco y se usa en muchos sitios es MkDocs. Te soluciona automaticamente todo lo que es el layout de la documentacion y se escribe todo en Markdown. Y a partir de eso te genera automaticamente todo los html y css estaticos para subirlo donde quieras. Inclusive hay formas sencillas de subirlos a las wikis de GitHub, Gitlab, etc.
>
> https://www.mkdocs.org/
>
> Lo tiro por si no lo conocian y capaz le soluciona bastante de las problematicas en lo que respecta a la documentacion. Es muy facil de usar. Lo bueno es que si lo quieren versionar solo necesitan versionar los Markdown. Y no el resto de la basura.
>

Mkdocs esta genial, y Eric lo estuvo usando para varias cosas. Es una
de las opciones que manejamos para el tema de la pagina tecnica (que
derive en la wiki o algo así)

Ahora... teniendo la wiki? hace falta la pagina de github? Teniendo la
pagina de github hace falta la wiki? La ventaja de la wiki en github
es que es fácil editarlo online y no necesita generación de HTML
estático... la desventaja es que te da menos flexibilidad para armar
un aspecto visual (es necesario eso?)

Las wikis de que proporciona gitlab/github son básicamente un repo al
que se puede acceder con commit/pull/push/pull-request asi que
tendríamos todas las ventajas de usar una pagina de proyecto y ninguna
de las desventajas de tener que generar código html cada vez que se
commitea (cosa que se puede automatizar, no lo niego... pero hay que
hacerlo jejejeje)

Que opinan?

[Marcos Hernán García]

Si ya tienen la doc en MkDocs, pueden subirlo a la wiki de Github automaticamente:

https://www.mkdocs.org/user-guide/deploying-your-docs/

Por eso para mi el mejor approach que se puede hacer en este tema, es escribir y armar todo con MkDocs (por ser raipdo y facil)  y deployarlo en la wiki de Github con los utilitarios que ya provee MkDocs.

[Carlos Pantelides]

Marcos, hay dos partes actualmente:

La landing page, que es código html+css estàtico, que es indispensable para la gente no técnica, responde a motivos "de negocio". De todos modos tiene un muy bajo costo de mantenimiento.

La wiki en mediawiki, cuya conversión/traducción/reemplazo por github estoy completamente de acuerdo, pues como dice Martín, es para gente técnica que no necesita el eye candy.

[Jorge]

Es un tema interesante a tratar, en este caso estoy de acuerdo con Carlos, me parece perfecto pasar todo lo técnico a github porque no es eficiente mantener dos sitios actualizados con la misma información. En la Wiki se puede dejar la parte comercial y en todo caso una sección donde se nombran los proyectos con un link al github.

Saludos!!!  

Jorge R. Osio

[David Broin]

Buenas noches gente, reavivando un poco este tema. ¿Quieren que yo me haga cargo de esto? ¿Con quién me tendría que coordinar?

Saludos.