Closed binary-sequence closed 11 years ago
Genial, me gusta que se vea la API en la web, buenismo!!!
La documentación la borraría de master, evitaría que tengamos las cosas en dos lados... ¿que te parece a vos?
Eso mismo pensé yo. Iba a enviarte el 'pull request', pero me surgieron algunas dudas.
Si se elimina de la rama master, alguien que descargue pilasweb usando el botón "zip" de Github, no descargará la documentación; debería tener acceso a internet o se podría empaquetar la documentación para descargar independientemente o, se podría empaquetar junto con pilasweb para descargar conjuntamente (A través de la página "oficial" de pilas, por ejemplo, y no a través del botón "zip" de github). Además, en el índice del proyecto se muestra un enlace a la copia local de la documentación. Si se elimina éste, se puede cambiar el enlace hacia 'hugoruscitti.github.com/pilasweb' o, en el caso de empaquetar la documentación en un zip independiente, el link de descarga. ¿O tienes pensada otra cosa?
Interesante... no había pensado en eso...
Si te parece bien, podemos hacer así: Dejar la documentación solo accesible desde la página, y luego vemos como generar un zip para que se pueda descargar.
Serían dos zips, uno para pilasweb y otro para la documentación. Lo podríamos hacer luego si te parece.
Algo así es cómo se ofrece la documentación en la versión de pilas python, por separado:
http://www.pilas-engine.com.ar/documentacion
El 19 de noviembre de 2012 14:14, binary-sequence notifications@github.comescribió:
Eso mismo pensé yo. Iba a enviarte el 'pull request', pero me surgieron algunas dudas.
Si se elimina de la rama master, alguien que descargue pilasweb usando el botón "zip" de Github, no descargará la documentación; debería tener acceso a internet o se podría empaquetar la documentación para descargar independientemente o, se podría empaquetar junto con pilasweb para descargar conjuntamente (A través de la página "oficial" de pilas, por ejemplo, y no a través del botón "zip" de github). Además, en el índice del proyecto se muestra un enlace a la copia local de la documentación. Si se elimina éste, se puede cambiar el enlace hacia ' hugoruscitti.github.com/pilasweb' o, en el caso de empaquetar la documentación en un zip independiente, el link de descarga. ¿O tienes pensada otra cosa?
— Reply to this email directly or view it on GitHubhttps://github.com/hugoruscitti/pilasweb/pull/25#issuecomment-10522006.
Hugo Ruscitti
www.pilas-engine.com.ar www.losersjuegos.com.ar www.gcoop.coop
En la issue #13 parece que aún no lo teníais claro, pero mientras os lo pensabais se estaba mostrando la plantilla de github. Puede mostrarse la API mientras decidís cómo hacer la página.
¿Pretendéis borrar la documentación de la rama master o la vais a dejar para que se distribuya junto al código?