DocuWiki de la CIAA con code inyection
18 views
Skip to first unread message
Eric Pernia
Apr 24, 2019, 10:21:59 AM4/24/19
to ciaa-coo...@googlegroups.com, CIAA-Firmware, CIAA-Hardware, Martin Ribelotta, Carlos Pantelides
Buenos dias, encontré esto hoy en la wiki del proyecto CIAA:
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
Apr 24, 2019, 10:30:48 AM4/24/19
to Eric Pernia, ciaa-coo...@googlegroups.com, CIAA-Firmware, CIAA-Hardware, Carlos Pantelides
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ó:
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
Apr 24, 2019, 11:19:46 AM4/24/19
to martin ribelotta, Eric Pernia, ciaa-coo...@googlegroups.com, CIAA-Firmware, CIAA-Hardware
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
martin ribelotta
Apr 24, 2019, 11:26:21 AM4/24/19
to Carlos Pantelides, Eric Pernia, ciaa-coo...@googlegroups.com, CIAA-Firmware, CIAA-Hardware
El mié., 24 abr. 2019 a las 12:19, Carlos Pantelides
(<carlos.p...@gmail.com>) escribió:
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.
(<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...
> 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
>
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
Apr 24, 2019, 11:30:01 AM4/24/19
to Marcos Hernán García, Carlos Pantelides, Eric Pernia, ciaa-coo...@googlegroups.com, CIAA-Firmware, CIAA-Hardware
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?
>
> 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.
(<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?
>
> 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.
Carlos Pantelides
Apr 24, 2019, 1:37:57 PM4/24/19
to Marcos Hernán García, martin ribelotta, Eric Pernia, CIAA-Firmware, CIAA-Hardware
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.
On Wed, Apr 24, 2019 at 12:37 PM Marcos Hernán García <marcos....@gmail.com> wrote:
Si ya tienen la doc en MkDocs, pueden subirlo a la wiki de Github automaticamente: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.
Reply all
Reply to author
Forward
0 new messages