¿Desarrollo de Tutoriales?

[AeroCross]

Me estaba preguntando donde podríamos mostrar los tutoriales correctamente.

Según la página de Wiki de los repositorios para aprender lenguajes, la carpeta "Tutorials" será utilizada exclusivamente para "la teoría del lenguaje" (corríjanme si me equivoco, por favor). Esto significa que, técnicamente, los tutoriales son código fuente o texto plano (ya sea Markdown, HTML, etc.).

Me preguntaba, ¿no sería mejor que los tutoriales estuviesen en Wikis del mismo lenguaje?

Claro, esa carpeta podría tener 2 usos fundamentales:

1. Código fuente de muestra para las "lecciones", contenidas en la Wiki.

   Esto significa que si, por ejemplo, en la lección "Funciones", tengo un código simple que muestra la sintaxis de una función. Ese código de referencia estará en la carpeta "Tutorials".

2. La fuentes planas de lo que está en la Wiki.

   Por ejemplo, si en la Wiki se puede escribir en Markdown, la fuente de ese documento podría ser la misma que está en la Wiki, para tenerla como referencia — de la misma naturaleza de un README, por decirlo así.

Mi pregunta surge del nombre de la carpeta. Por definición, la carpeta "tutorial" debería enseñarte a hacer algo puntual (un blog, un URL Shortener, un task manager, etc.), no aprender todo el lenguaje, ¿o es que estoy viendolo de una manera diferente?

Sería bueno que se aclarara un poco de ese asunto, IMHO.

¡Espero su feedback! Muchas gracias.

[sadasant]

Hola Mario!

Fíjate, justamente estaba pensando en un blog :) Lo que haremos es utiliar las Project Pages de Github, tal como estoy empezando a hacer con http://openve.github.com/ <-- haremos una para cada lenguaje y en ella colocaremos tutoriales separados por categoría, esos van dentro del repositorio en la branch gh-pages tal como indica la guía: https://help.github.com/articles/user-organization-and-project-pages :) ¿Qué te parece? Iré haciendo esas webs a medida de lo posible, sería bueno si nos coordináramos para trabajar en conjunto!

[phanghos]

Que excelente, veo que poco a poco esto va tomando forma!

[AeroCross]

Pero ¿será como lo tienes ahí en este momento que el enlace lleva al repo, o se desarrollará como una sección para cada lenguaje, como en Bootstrap?

Eso podría funcionar — eso significa que todos trabajaríamos bajo un mismo esquema y cada quién podría ir aportando a su área. Quizás sea un poco más engorroso (de verdad todavía no se como funcionan las Project Pages) ¡pero a la larga sería la mejor opción!

¿Alguien aquí es diseñador innato o cómo basamos ese diseño? xD

[AeroCross]

Eso es correcto, @phangos! Poco a poco — esto es, como dicen, "pa'largo!"

[sadasant]

:D sí sí falta mucho. En cuanto a la estructura, no será como puse ahí, es decir, si habrá un enlace por "repo", pero no irá al código, sino a la página de repo, que contendrá los tutoriales y eso :D también haré un sistema de documentación literal de código, como http://jashkenas.github.com/docco/ pero espero que mejor, no se bien! De momento mi enfoque es terminar la web principal y hacer una web introductoria a cada repo dentro de cada repo. Let's do this?

[AeroCross]

I'm in =P

Voy a ver si el fin de semana me pongo con ese sitio. ¿Y si usamos algo como Bootstrap o Foundation? ¿O por lo menos Skeleton?

Eso facilitaría la "diagramatización" (amirite?) del sitio, y nos da un entorno común para trabajar. What do ya say?

BTW... Docco está sweeeet. Oh, Node. Oh, Javascript.

[sadasant]

Tiendo a ser más en pro a vanilla css y js, :/ por ahora iré montando las cosas en ese estilo :) más adelante cualquier mejora es bienvenida :D

[AeroCross]

Yo como mínimo (después de pasar TANTO trabajo diagramando durante tantos años) uso es un Grid Framework (como 960.gs o 1140px) porque de verdad que manejar todo eso es muy, muy, muy tedioso e inconsistente. Creo que con el Grid Framework tendríamos, y los estilos los vamos agregando nosotros =) Claro, IMHO.

No se, ¿qué opinan los demas?

—summons people from Open Venezuela—

Con lo del Vanilla JS, estoy de acuerdo — en realidad uso es jQuery, pero meh, quizás no se tenga que usar tanto, ¿quién sabe?

[sadasant]

Bueno, let's do this, ¿Cómo empezamos con Grid Framework? I just code whatever I feel right to code, enlighten me.

[sadasant]

Podemos usar jQuery sin rollos, mientras más seamos será mejor usar frameworks, así se mantiene el código ordenado :) como había empezado yo, estaba sin cuidado, pero es cuestión de definirnos.

[AeroCross]

Bueno, podemos usar la Grid de Bootstrap (eso es solo el grid, sin estilos) que muchos deben estar familiarizados con él, y la diagramación será simple:

<div class="container">

    <div class="row">

        <div class="span6">

            <p>Esto ocupa la mitad de la pantalla.</p>

        </div>

        <div class="span6">

            <p>Esto ocupa la otra mitad de la pantalla.</p>

        </div>

    </div>

    <div class="row">

        <div class="span4">

            <p>Esto ocupa 1/3 del contenedor.</p>

        </div>

        <div class="span4">

            <p>Esto ocupa 1/3 del contenedor.</p>

        </div>

        <div class="span4">

            <p>Esto ocupa 1/3 del contenedor.</p>

        </div>

    </div>

</div>

Podemos usar el 960.gs que es muy famoso, o cualquier grid que la comunidad esté más familiarizada.

Cualquier cosa, podría añadir cierto código y ver si les agrada luego, ¿no les parece?

[sadasant]

Me parece buena idea! :) ¿Nos puedes ayudar implementándolo en la web actual de OpenVE en este repo: https://github.com/OpenVE/openve.github.com ? Tengo tiempo para trabajar un rato esta noche y mañana durante el día, así la sacamos más rápido :)

[AeroCross]

There you go man! Chequea el 18eedbd02cf1 y ve que tal. Traté de dejarla lo más parecida posible sin tener que usar tantas clases y tanta especificación, así será un poquito más simple de usar. ¡Dime que opinas!

Y creo que este caso está cerrado. ¡Creo que podremos continuar esta conversación (sobre el sitio) en otro issue de ser necesario!

¡Saludos a todos!

[sadasant]

Está genial Mario :) mañana sigo en base a eso entonces. Gracias por colaborar y espero verte por ahí más tiempo! jeje, feliz noche!