Sugerencia: Cambiar estilo de las guías.

[rpalaciosg]

Hola amigos, esto es una sugerencia, se que ha sido un largo proceso y trabajo para crear las guías de colaboración y demás. Y que aun se siguen completando y mejorando estas guías.

A mi parecer las guías están muy bien escritas, son directas y fáciles de entender y gracias a esas guías he aprendido a usar git, github y algo de nikola.

Mi sugerencia es: Que tal si se da un nuevo diseño a las guías del sitio de Python Ecuador, algo parecido a las documentaciones que se crean en Read the docs, ya que a mi criterio son agradables en el diseño y organización; por lo tanto pienso que facilitará aun mas seguir las guías.

A continuación pongo unos ejemplos, del estilo al que me refiero:

Yo se que el cambio implicaría mas trabajo de diseño, maquetación, creación de plantillas, y no se aun que cosas mas.

Esto no seria un cambio inmediato sino mas bien una mejora, y en caso de que la comunidad este de acuerdo o le interese esta sugerencia, se podría ir trabajando en paralelo en un nuevo branch, hasta que se pueda tener listo/probado el cambio y hacer la transición.
Creo que hasta se podrían sacar varias tareas para trabajar en un pyPizza por ejemplo y que podría ser un cambio a beneficio de la comunidad.

Dejo abierto el tema, a cualquier sugerencia, si les interesa.

Saludos.

[stsewd]

Para usar el tema de Read the Docs, podríamos usar sphinx sólo para la documentación relacionada a contrbuir al repositorio, pero esto significaría un paso más que aprender/configurar para los usuarios, y tendríamos la limitación de no poder enlazar la otra documentación.

La otra manera sería imitar el css del tema sólo para la parte de las guías, la verdad, no sé si valdría la pena.

Te parece mejor el estilo de rtd porque el contenido está a un lado? Creo que podríamos lograr algo así sólo editando un template

[rpalaciosg]

Te parece mejor el estilo de rtd porque el contenido está a un lado?

Hola @stsewd, la verdad sí, se hace mas legible el estilo RTD por el contenido a un lado.

Creo que podríamos lograr algo así sólo editando un template

Y exactamente eso, no necesariamente se debe usar otro tema, sino dar el estilo a un template con el css como dices, si es posible así, seria una forma mas rápida de hacerlo.

¿Que te parece la idea?

[gomezgleonardob]

Como van a proceder antes de hacer el nuevo commit en las guías ,gracias por la respuesta

[stsewd]

@gomezgleonardob aún no está decidido, la guía actual aún sirve

[rpalaciosg]

Hola @gomezgleonardob, la verdad esta como sugerencia aun no se decide nada por parte de los que mantienen el repo, creo que como contribuidores podríamos hacer Pull Request con alternativas a la sugerencia en nuevas ramas, o tal vez los mantenedores del repositorio abrir issues separados como tipo tareas para que la comunidad aporte. Pero esto solo en el caso de que la comunidad y mantenedores este de acuerdo con la sugerencia. La única forma de medir un impacto seria una demo funcional. Y claro la guía actual sirve muy bien, esto es solo una sugerencia de mejora.

[Seburath]

Voy a añadir un template con una barra de navegacion lateral, mandarlo a Read the Docs seria lo mas chevere, pero luego seria un dolor de cabeza al momento de contribuir y ver cambios.