¿Qué es un consejo para crear un sitio web de tutoriales?

Gracias por A2A ..!

Considera las siguientes cosas:

  • Utilice el mejor CMS para crear dicho sitio web.
  • Intenta hacerlo multilingüe para atraer a un público más amplio.
  • Mantenga las cosas simples y estúpidas. Tu lenguaje debe ser tan simple que deberías pensar que estás enseñando a un grupo de monos. Las personas pierden la fe en la programación si piensan que es complejo de entender.
  • Intenta incrustar un compilador en línea. Así los usuarios pueden probar el código mientras aprenden.
  • Asegúrese de alentar la documentación adecuada y su propio código de ejemplo está debidamente comentado. Porque las personas que van a aprender de su sitio web son las que trabajarán conmigo o bajo mi cargo como futuro ingeniero de software, así que tendré que asegurarme de que estén aprendiendo de una buena fuente. 😛
  • Por último, pero no menos importante, trata de hacerlo divertido como “Academia Khan”.

Para ver un buen ejemplo de emulación, consulte el tutorial de Javascript de Khan Academy. Me gustaría señalar los aspectos más destacados:

  1. Codificación dentro del navegador, sin tener que instalar ningún compilador o intérprete o software
  2. Evaluando el código inmediatamente
  3. Sugerencia de sugerencias para aplicar correcciones antes de que finalmente se evalúe.
  4. Insignias para completar una tarea para mantener al alumno motivado.

Hay otros enfoques que puede adoptar desde MOOC como edX, Coursera, etc. Pero este es el punto crucial: “¿Cómo puede mantener al alumno lo suficientemente motivado para obligarlo a regresar a su sitio web de tutoría día tras día?”

Intenta que sea breve y simple.
Trate de mostrar todos los casos de uso comunes de un concepto.
Múltiples ejemplos con entrada y salida funcionarían mejor.

Gracias por A2A

Codifico mucho y soy programador de nivel intermedio. Por lo tanto, soy elegible para responder. No pretendo hablar sobre los menús / botones / estilo del sitio web, pero sobre todo sobre el contenido. Entonces, aquí va …

  • Proporcione requisitos previos claros y enlaces para leer sobre ellos (no asuma ningún conocimiento previo del lector).
  • explique por qué los métodos que el lector ha aprendido de un tutorial anterior no funcionan cuando lo está mejorando (por ejemplo, cuando explica el DP, explique claramente la cantidad de pasos que se reducen de la recursión ingenua).
  • intente generalizar un problema cuando vaya a explicar. No resuelva exactamente un problema y diga que otros siguen el mismo método (me refiero a poner algunas reglas generales que se deben seguir para saber qué método / algo en particular se debe usar) Siempre escriba un código que explica la implementación de algoritmos (al menos psuedocode). [Las personas primero deberían encontrarlo funcionando en ese momento y luego pensarán en aprender por qué funciona]
  • Dígales métodos alternativos para hacer lo mismo (algunos se sienten bien cuando trabajan con recursión, a otros les gusta iterar. Por lo tanto, publique un resumen de otro método para que no pierda esos lectores).
  • Creo que los tutoriales de TOPCODER te dan una idea de cómo escribir tutoriales.

Hacer

  1. Primero, haz un buen entendimiento de esos temas … Que vas a usar Para hacer tutoriales
  2. Use un método fácil. Haga una presentación. Trate de hacerlo simple.
  3. Usa ejemplos …

No hacer

  1. Nunca escribas tutoriales en los que no tengas ninguna experiencia ..
  2. Nunca copie otros tutoriales: afectará la clasificación de su sitio web en el motor de búsqueda

Puedes comenzar algo como w3school, tutorial punto a punto, lenguaje fácil pero también incluye un foro de discusión para cada tema

Hazlo directo al punto.
Le encantará si puede incluir las mejores prácticas / patrones / uso de los artefactos de programación extrayendo de fuentes como stackoverflow / github / msdn y otras.