Estándares de Desarrollo Front-end de Isobar http://na.isobar.com/standards
Todo el contenido está licenciado bajo Licencia de Atribución 3.0 de Creative Commons
Este documento contiene directrices para aplicaciones web creadas por el equipo de trabajo de Tecnología Creativa (Ingeniería de Front-end) de Isobar North America (anteriormente Molecular). Se creó a fin de hacerse disponible para cualquier persona que desee revisar o contribuir al progreso iterativo de las prácticas recomendadas de nuestra disciplina.
La motivación principal de este documento tiene dos aristas: 1) consistencia de código y 2) prácticas recomendadas. Al mantener la consistencia en los estilos y convenciones del código, podemos aliviar la carga del mantenimiento del código legado (desactualizado) y mitigar los riesgos de daño en el futuro. Adhiriéndonos a prácticas recomendadas aseguramos unos tiempos de carga de página, desempeño y código mantenible optimizados.
Los estándares de código son documentos vivientes y deben cambiar para reflejar las últimas prácticas recomendadas, liderazgo de pensamiento y tendencias tanto en la comunidad en la que busca estandarizar sus prácticas, como en la gran comunidad de desarrollo en general. El desarrollo front-end es una de las disciplinas de mayor crecimiento en el desarrollo de software. Para asegurar que nuestros estándares son capaces de mantener el ritmo, deseamos que haga fork a nuestro proyecto en github, discuta las nuevas adiciones, nos envíe pull requests y añada issues para debatir los estándares y prácticas emergentes.
Esperamos estimular a otros desarrolladores a pensar en como estandarizar mejor sus enfoques de desarrollo, a someter sus propias ideas al debate y proponerlas para su inclusión en nuestra versión del documento, así como a adaptar nuestros estándares a sus propias prácticas de desarrollo. ¿Qué mejor manera de lograr un consenso sobre como desarrollar mejor en nuestra disciplina que a través del feedback de los propios miembros de dicha disciplina?
El archivo index.php se usa para incluir cada uno de los archivos .html contenidos en el directorio /sections/. Hemos separado las diferentes secciones que componen la página en archivos individuales, de manera que sea más fácil editarlos, haciendo el contenido de la página más modular, básicamente. Esto también es parte de lo que consideramos una práctica recomendada cuando se trabaja con proyectos de grandes dimensiones, como si se tratara de una aplicación con mucho código y en la que trabajan varias personas.
Cada uno de estos archivos incluyen contenido separado en secciones. Esto debería ser auto-descriptivo, creo. En cada sección hacemos uso repetido de todas las etiquetas de encabezados h1-h6, dado que el HTML5 le permite utilizar tantas como desee. Por supuesto, nosotros siempre intentamos usar éstas, así como todas las demás etiquetas HTML5, adecuadamente, haciendo uso de etiquetas semánticas donde tiene mayor sentido.
Refiérase al esquema HTML5 del documento en el wiki para tener una mejor idea de la arquitectura de la página: http://goo.gl/xEjB5