Publicidad
Publicidad

RSS Documentación

Define el diseño de tus APIs con Blueprint, RAML o Swagger

Comentar
Define el diseño de tus APIs con Blueprint, RAML o Swagger

Muchas veces desbordados por las necesidades (urgentes) exponemos componentes internos de nuestras aplicaciones en servicios REST públicos. La inercia nos ha llevado a ir creando este tipo de APIs sin un diseño previo. Lo que conlleva problemas por la falta de planificación, lo que se traduce en la inconsistencia entre los objetos y métodos, sin hablar de agujeros de seguridad.

Afortunadamente, la tendencia está cambiando. Cada vez toma más importancia el diseño previo de APIs utilizando herramientas que tengan en cuenta la usabilidad, la necesidades de los consumidores/aplicaciones que vayan utilizar los servicios, permitan realizar mocks testeables, posibilitar el versionado y, por supuesto, crear de forma conjunta al desarrollo de la documentación.

API Blueprint, RAML y Swagger representan tres excelentes herramientas para diseñar APIs. Podemos diseñar sobre el papel antes de su implementación la definición de la API en formato JSON o usando markdown para describir la interfaz, estructura y el modelo de datos.

Leer más »

La anatomía de un motor de búsqueda hipertextual Web a gran escala, los inicios de Google

2 Comentarios
La anatomía de un motor de búsqueda hipertextual Web a gran escala, los inicios de Google

Hoy traigo un documento que es una auténtica joya para diferentes y variados ámbitos del conocimiento de la informática.

Y no es otro que el documento de presentación del prototipo de Google, por Sergey Brin y Lawrence Page, en donde describen al detalle el modelo y arquitectura; utilizando “solamente” 24 millones de páginas para obtener resultados.

Leer más »
Publicidad

Referencia rápida de comandos de GIT

3 Comentarios
Referencia rápida de comandos de GIT

Que GIT es el repositorio de código con más éxito entre la comunidad de desarrollo es una realidad que se ha instaurado en los últimos tiempo. Incluso Microsoft ha integrado este repositorio con su herramienta de ALM, TFS Service.

Pero el número de comandos que debemos tener la memoria puede llegar a ser apabullante, y para ayudarnos a tenerlos a mano hoy traigo una imagen en donde tenemos ordenados la mayoría de las acciones que podemos realizar.

Leer más »

Ahora en Github puedes escribir en modo Zen

1 Comentario
Ahora en Github puedes escribir en modo Zen

Github, el servicio de alojamiento de software de moda donde todo el mundo quiere estar, estrenó hace un par de días una curiosa nueva funcionalidad a la que han llamado Zen Writing Mode. Y es que con el paso del tiempo Github se ha convertido en algo un poco abigarrado y sobrepoblado en el que las distracciones pueden ser múltiples. Lo que hace este Zen Writing Mode es eliminar estas distracciones para que te centres en lo principal y más difícil, escribir.

Leer más »

El 26 de noviembre empieza la Google Code-in para promover el software libre

10 Comentarios

Google, como desde hace tres años, ha puesto en marcha el concurso para chavales preuniversitarios con edades que comprenden desde los 13 años hasta los 17 y durará 50 días, donde el objetivo no es solo que haya jóvenes que programen o creen algún proyecto libre, sino que el objetivo es concienciar a los jóvenes lo importantísimo que es el software libre.

Leer más »
Publicidad

Se publica la Visual Studio 2012 Product Guide

11 Comentarios
Se publica la Visual Studio 2012 Product Guide

Desde septiembre del año pasado, estoy utilizando de forma personal y profesional diferentes versiones de Visual Studio 2012: Preview, RC y ahora la RTM de este excelente IDE. De hecho, es el único IDE aconsejable para trabajar en tecnología .NET.

Hay, ciertamente, mucha literatura sobre la herramienta, y todas su inacabables e inabarcables capacidades, características y usos.

Pero hoy quiero compartir un documento que se ha publicado por Microsoft y que es la Guía de Producto de Visual Studio 2012, y que es un “tocho “ de documento de 210 páginas llenas de toneladas de información que todo usuario de la herramienta debiera, al menos, echar un vistazo en la parte que le concierna.

Leer más »

Windows 8 touch guidance

3 Comentarios
Windows 8 touch guidance

El usuario itproes acaba de publicar en slideshare un excelente documento de guía sobre la interfaz táctil de dispositivos con Windows 8.

La presentación está dividida en varias secciones, a cada cual más interesante. En la que se describe, de forma visual y concisa, los principales conceptos que debe tener en cuenta el desarrollador al crear su interface gráfico de la aplicación.

Leer más »

Hojas de estilo mantenibles y documentadas con KSS

1 Comentario
Hojas de estilo mantenibles y documentadas con KSS

Ya hemos comentado en más de una ocasión que darse un paseo virtual por GitHub es sinónimo siempre de encontrar proyectos realmente interesantes. Uno de ellos es KSS (de Knyle Style Sheets), un proyecto de un usuario bastante prolífico y conocido llamado Kneath con la intención de proveer una metodología para escribir ficheros CSS mantenibles y documentados. Esto, cuando se trata de un proyecto unipersonal quizás no es del todo necesario (aunque a mi personalamente si que me lo parece) pero cuando hay varias personas tocando los estilos, eso puede ser la Guerra de Corea (o el primer día de rebajas en El Corte Inglés de Sol): un descontrol al que hay que meter en vereda.

Desde luego que hay más opciones para realizar esta tarea (podéis comentar vuestros favoritos en los comentarios) pero este KSS tiene buena pinta porque está muy orientado al trabajo con preprocesadores CSS como LESS, tiene una estructura jerárquica (lo que ayuda a no repetirse) y porque el proyecto está bien documentado (faltaría más, ¿no?) y contiene bastantes ejemplos tanto de implementación como de resultados.

Cuantas más posibilidades haya para que nuestro trabajo sea mejor, más organizado y menos costos, mejor. Pues eso.

Vía | GitHub

Leer más »
Publicidad
Inicio
Inicio

Ver más artículos