clase19.md

Máster en Programación FullStack con JavaScript y Node.js

JS, Node.js, Frontend, Backend, Firebase, Express, Patrones, HTML5_APIs, Asincronía, Websockets, Testing

Clase 19

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;
};

Recursos

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

Otras herramientas de documentación

• swagger
• jGrouseDoc
• YUIDoc
• DOCCO

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

Recursos

• JS The Right Way
• JavaScript Clean Coding Best Practices - Node.js at Scale
• Clean Code JavaScript in CSS-TRICKS
• JavaScript Best Practices
• Untangling Spaghetti Code: How to Write Maintainable JavaScript
• Uncle Bob’s Clean Code: Irrelevant in the Age of Full-Stack JavaScript?

Analizar la calidad de tu código

• Code Climate
• deepscan.io
• codebeat.co
• codacy

ChromeDevTools: Avanzado

• 📺 Chrome DevTools 101: Debugging JavaScript
• 📺 Debugging The Web (Chrome Dev Summit 2016)
• 📺 Debugging JavaScript - Beginner to Advanced in One Video
• 📺 Mastering Chrome Developer Tools with Jon Kuperman
• 📺 Effective Browser JavaScript Debugging
• 📺 Chrome DevTools Masterclass
• 📺 Fast By Default: Modern Loading Best Practices (Chrome Dev Summit 2017)
• 📺 Debugging your website with Fiddler and Chrome Developer tools - Robert Boedigheimer
• 📺 Debugging The Web
• 📺 Become a Javascript Console Power-User
• 📄 Comenzar a depurar JavaScript en Chrome DevTools
• 📄 JavaScript Debugging Reference
• 📄 Pause Your Code With Breakpoints

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