hugoruscitti / pilasweb

Versión de pilas-engine para navegadores usando HTML5.
www.pilas-editor.com.ar
17 stars 10 forks source link

Crear web de repositorio (gh-pages) para mostrar los ejemplos y la API. #34

Open binary-sequence opened 11 years ago

binary-sequence commented 11 years ago
hugoruscitti commented 11 years ago

Con respecto a la api, estoy investigando un poco sobre css y javascript para hacer algo muy parecido a lo siguiente:

http://cheat.markdunkley.com/

¿que te parece?

binary-sequence commented 11 years ago

Creo que puede ser útil como cartilla de referencia. Es una buena forma de tener a mano la funcionalidad.

Al principio no me ha convencido mucho. Pero acabo de caer en la cuenta de que una cosa es la documentación para desarrolladores (a lo que yo estaba llamando API) del proyecto pilas web y, otra cosa es una API para un usuario/estudiante cuya intención es usar pilas. La API para desarrolladores en la que yo estaba pensado en JsDuck, es mas útil con JsDuck que con lo que me has enseñado. Pero, sería bueno para un usuario que lo que le interesa es buscar el método iniciar y saber qué parámetros pasarle. O simplemente revisar qué acciones puede realizar.

¿Lo planteamos así?

hugoruscitti commented 11 years ago

Si, me parece excelente. De hecho, una cartilla de referencia es fácil de imprimir, y tenerla a mano en un panel dentro de pilas-editor etc...

Y si, jsduck me gusta mucho para los desarrolladores que exploran con mas profundidad.

Me parece perfecto, hoy mismo intento terminar la cartilla de pilas-web y explorar jsduck, te aviso.

hugoruscitti commented 11 years ago

Estuve avanzando con la cartilla de referencia:

Cartilla_de_referencia_pilas-engine_ _A_Toolkit_Component

Es un poco mas difícil de lo que imaginaba, pero queda muy bien realmente.... Estoy haciendo estas pruebas en otro repositorio:

https://github.com/hugoruscitti/cheatsheet.git

En cuanto lo tenga mejor adaptado para modificarlo espero ponerlo dentro del repositorio de pilas.

¿que te parece?

binary-sequence commented 11 years ago

¡Estupendo!