Proyecto PyCamp 2024
akielbowicz opened this issue · 2 comments
Como actividad del PyCamp 2024 vamos a trabajar en organizar un poco la wiki, este issue engloba las distintas ideas que fueron surgiendo sobre las cuales vamos a trabajar:
- Definir un nuevo indice que sea mas accessible
- Reconocer distintas categorias de las paginas para estructurar como esta organizado
- Eliminar paginas que no tienen ningun contenido
- Archivar contenidos viejos
- Revisar paginas que no estan linkeadas o no se pueden acceder siguiendo links desde el indice
- Agregar un motor de busqueda al sitio
- Actualizar dependencias para poder buildear la wiki localmente
Buenas, estuve recorriendo la wiki e identifiqué algunas posibles tareas. Quedan cargadas acá para priorizar/definir como encarar el trabajo en el PyCamp:
-
Actualizar readme
- pensar si hace falta agregar alguna otra info
- Linkear a docs de Nikola.
-
Índice
-
Quitar del índice items que ya están en la navbar
- quienes somos
- eventos
- foros y redes
- trabajos
- donaciones
- etc...
-
Revisar jerarquía. Priorizar estos ítems:
- proyectos
- recursos
- aprendiendo py
-
-
Modificar/actualizar contenido eventos:
- Reuniones PyAr
- Sprints
- Conferencias
- Pycamp
-
wiki/gsoc/
- agregar sigla entre paréntesis a título del vínculo
- revisar errores de sintáxis en la página en algunos links
-
aprendiendopython
- actualizar contenido
- enlazar con Adopta un newbie
-
tareas pendientes
-
archivar. Las tareas pendientes se generan en issues en github.
-
FAQs
- actualizar contenido (por ejemplo dice que se usa MoinMoin para la wiki, reemplazar por Nikola) especialmente en las herramientas recomendadas.
- tiene sentido migrar preguntas técnicas a otro FAQ?
- Agregar a FAQ para que puedo usar python o algo en ese sentido.
-
-
Material:
- Archivar
-
Adopta a un newbie:
- se está usando?
- actualizar
- revisar el proceso
- enlazar con Aprendiendo python
-
Otras ideas:
- Librerías más utilizadas en Python
- Link a páginas personales
- Botón para obtener contenido "aleatorio" de entre las páginas personales de la wiki
- Mejorar diseño general desde template de Nikola
- Colaborar con proyecto Charla secundarios y Podcast para unificar/compartir contenidos
@franchardin esto puede ayudar a organizar https://danielsieger.com/blog/2023/04/24/framework-for-better-documentation.html