dia26.md

Master en Programación de Aplicaciones con JavaScript y Node.js

JS, Node.js, Frontend, Express, Patrones, IoT, HTML5_APIs, Asincronía, Websockets, ECMA6, ECMA7

Clase 26

JSDocs

/** @namespace */
var app = {};

/**
 * Resuelve la división de a/b
 * @example
 * // retorna 3
 * globalNS.metodo(5, 15);
 * @returns {Number} Retorna el resultado de la operación.
 */
app.metodo = function (a, b) {
    return b / a;
};

• Documentación oficial
• Speaking JavaScript (Axel Rauschmayer) - Chapter 29. JSDoc: Generating API Documentation

Guías de estilo

• idiomatic.js
• MDN Coding style
• Airbnb JavaScript Style Guide
• Google JavaScript Style Guide

Todo el código en cualquier proyecto debería verse como si una sola persona lo hubiera escrito, sin importar cuánta gente haya contribuído. Idiomatic.js

Desventajas:

• Adopción total del equipo
• Curva de aprendizaje
• Falta de plugins

Versionamiento Semántico (Semver)

semver

Rendimiento

• jsPerf
• benchmark.js

Tiempo para proyecto personal y terminar ejercicios pendientes!

nota: Si vas muy bien de tiempo, puedes meter estilos y más dinamismo al proyecto: Github | Social Network Project