Dash, Zeal y DevDocs: así puedes organizar tu repositorio de APIs
El mundo del desarrollo del software va subido en un Ferrari por una autopista alemana. Cada vez son más los lenguajes de programación, marcos de desarrollo, intérpretes por el lado del servidor, bases de datos y APIs que es necesario manejar para lanzar proyectos competitivos. En torno a esta gran explosión, nacen nuevas herramientas vinculadas a gestión y productividad. Un ejemplo perfecto de ello son los organizadores de interfaces de programación de aplicaciones.
Hoy en día existen dentro del mercado varios organizadores de APIs, documentación técnica de sintaxis y frameworks y librerías o bibliotecas de todo tipo. Los tres principales son Dash, Zeal y DevDocs. Son posiblemente las tres soluciones más utilizadas por la comunidad de desarrolladores. Y tienen la ventaja de que eso les ayuda a evolucionar la herramienta de forma rápida y eficiente.
Dash: acceso a más de 150 APIs
Dash es una herramienta para iOS y OSX que permite a los desarrolladores navegar por documentación técnica de más de 150 APIs. Este organizador dispone de la documentación offline, cada usuario escoge qué información quiere descargar y Dash lo hace. Existe la posibilidad de que el desarrollador pueda crear sus propios documentos de información técnica o solicitar documentación de terceros.
Dash también permite su integración en gestores de paquetes de terceros para solicitar y descargar toda la documentación especial que sea necesaria para un proyecto: paquetes de Ruby (Ruby Gems), Scala, Java, C, C++, C#, Objective-C, Python, JavaScript, HTML, Dart, Go o PHP. Además, es posible descargar documentación de la página para desarrolladores Stack Overflow. La creación de docsets permite compartirlos con otros usuarios mediante una URL personalizada.
Una característica interesante de Dash, al margen de la búsqueda y descarga de documentación técnica, es la gestión de fragmentos de código en el organizador. Dentro de esta funcionalidad, destacan algunas ventajas muy útiles en desarrollo:
– Almacenamiento y reutilización de fragmentos de código.
– Etiquetado de esos fragmentos para su clasificación y ordenación.
– Resaltado de sintaxis.
En junio de 2015, Dash lanzó la tercera versión (Dash 3) para el sistema operativo Mac OSX, la última y mayor actualización por ahora. Algunos de los cambios fundamentales e incorporaciones en Dash 3 son peticiones de usuarios:
– Menos uso del espacio en disco gracias a un nuevo sistema de archivo de la documentación técnica: solo se descuelgan cuando se van a utilizar. Los creadores de Dash estiman que el uso de espacio se reduce diez veces.
– Restauración automática de pestañas: la herramienta lanza la sesión de trabajo en el mismo punto en la que se dejó la última vez.
– Sincronización de la configuración a través del Mac, incluyendo documentación técnica ya instalada, perfiles de búsqueda y favoritos.
– Apertura de páginas en local o en internet.
– Servidor de anotaciones de código abierto y configurable: los desarrolladores podrán hacer anotaciones con comentarios o ejemplos y establecer si esas anotaciones son sólo privadas o totalmente públicas.
Zeal: un Dash para Linux y Windows
Es un navegador offline de documentación técnica inspirado en Dash, pero para sistemas operativos Linux y Windows. Zeal aprovecha, por tanto, el espacio dejado por su competidor fuera del entorno de Apple. La idea de Zeal es que los equipos de desarrollo siempre puedan tener a mano la documentación de sus APIs o APIs de terceros, sin obligación de estar conectados a la Red y con la integración de su editores de texto como VIM, Sublime Text, Emacs o KTextEditor o entornos de desarrollo integrado (IDEs) como IntelliJ IDEA mediante el uso de plugins:
– Plugin para la integración de Sublime Text. La instalación de los paquetes para la integración de editores o IDEs se puede hacer mediante el control de paquetes, con Git (la conocida herramienta de control de versiones usando el comando git clone https://github.com/vaanwd/Zeal) o bien de forma manual (descargar el paquete de Zeal de su sitio en GitHub, descomprimir el archivo .zip y copiar la carpeta en el directorio de Sublime Text).
Además, Zeal dispone de algunas otras características también muy interesantes:
– Generar documentación técnica propia.
– Herramienta libre y de código abierto.
– Soporta documentación de todo tipo, muy similar a Dash: lenguajes de programación como JavaScript, Java, Ruby, Python, C, C++, C#, PHP, Dart, Go, .NET, Scala o HTML… y dentro de esas sintaxis soluciones como AngularJS, BackBoneJS, EmberJS, KnockoutJS, Bootstrap, CakePHP, Laravel, MongoDB, Ruby on Rails, symfony, Drupal, WordPress, Xamarin, jQuery… En total más de 198 grupos de documentación técnica de infinidad de plataformas.
Zeal es bastante sencillo de instalar. En el caso de disponer de sistema operativo Ubuntu, el usuario lo único que debe hacer es ejecutar estos tres códigos:
DevDocs, navegador offline con extensión para Chrome
DevDocs es otro navegador de documentación técnica de distintos lenguajes de programación, herramientas de desarrollo de software y APIs. Su creador es Thibaut Courouble, desarrollador del equipo actual de Shopify (creador de negocios online) y de CSSFlow, una de las páginas más interesantes de widgets libres en HTML5, CSS3 y Sass para el desarrollo front-end de interfaces de usuario.
Algunas de las características que definen a DevDocs son:
– Navegador offline de APIs: no es necesario estar conectado a internet.
– Dispone de una extensión para conectarse con Chrome.
– Es gratuito y de código abierto.
– Plugins de integración para editores como Sublime Text, Atom o Brackets.
Banco Bilbao Vizcaya Argentaria, S.A. titular de este portal utiliza cookies y/o tecnologías similares propias y de terceros para fines técnicos, de personalización, analíticos, de publicidad comportamental o publicidad relacionada con tus preferencias sobre la base de un perfil elaborado a partir de tus hábitos de navegación (por ejemplo, páginas visitadas). Si deseas obtener información más detallada, consulta nuestra Política de Cookies.
Panel de configuración de cookies
Este es el configurador avanzado de cookies propias y de terceros. Aquí puedes modificar parámetros que afectarán directamente a tu experiencia de navegación en esta web.
Cookies técnicas (necesarias)
Estas cookies son importantes para darte acceso seguro a zonas con información personal o para reconocerte cuando inicias sesión.
Denominación
Titular
Duración
Finalidad
gobp.lang
BBVA
1 mes
Preferencia de idioma
aceptarCookies
BBVA
1 año
Configuración Cookies aceptadas
_abck
BBVA
1 año
Ayuda a protegerse contra los ataques de sitios web maliciosos
bm_sz
BBVA
4 horas
Ayuda a protegerse contra los ataques de sitios web maliciosos
ADRUM_BTs
Salesforce Marketing Cloud
Sesión
Requerido para la supervisión del servicio, inherente al SFMC
ADRUM_BT1
Salesforce Marketing Cloud
Sesión
Requerido para la supervisión del servicio, inherente al SFMC
ADRUM_BTa
Salesforce Marketing Cloud
Sesión
Requerido para la supervisión del servicio, inherente al SFMC
ADRUM_BT
Salesforce Marketing Cloud
Sesión
Requerido para la supervisión del servicio, inherente al SFMC
xt_0d95e
Salesforce Marketing Cloud
Sesión
Recordar las preferencias del usuario (si las hay)
__s9744cdb192d044faa1bf201d29fafd1e
Salesforce Marketing Cloud
Sesión
Recordar las preferencias del usuario (si las hay)
wpml_browser_redirect_test
WPML
Sesión
Traducción de textos del portal
wp-wpml_current_language
WPML
24 horas
Traducción de textos del portal
Cookies de Analítica
Permiten medir, de forma anónima, el número de visitas o la actividad. Gracias a ellas podemos mejorar constantemente tu experiencia de navegación.
Dispones de una mejora continua en la experiencia de navegación.
Con tu selección no podemos ofrecerte una mejora continua en la experiencia de navegación.
Denominación
Titular
Duración
Finalidad
AMCV_***
Adobe Analytics
Sesión
ID de visitante único que se usan en las soluciones de Marketing Cloud
AMCVS_***
Adobe Analytics
2 años
ID de visitante único que se usan en las soluciones de Marketing Cloud
demdex (safari)
Adobe Analytics
180 días
Crear y almacenar identificadores únicos y persistentes
sessionID
Adobe Analytics
Sesión
Cookie interna de Launch usada para identificar al usuario
gpv_URL
Adobe Analytics
Sesión
plugin Adobe Analytics: getPreviousValue Capturar el valor de una determinada variable en la siguiente vista de página, en este caso la prop1
gpv_level1
Adobe Analytics
Sesión
Cookie utilizada para almacenar el levl1 del DataLayer de la página anterior.
gpv_pageIntent
Adobe Analytics
Sesión
Cookie utilizada para almacenar el pageIntent de la página anterior.
gpv_pageName
Adobe Analytics
Sesión
Cookie utilizada para almacenar el pagename de la página anterior.
aocs
Adobe Analytics
Sesión
Cookie que almacena los primeros valores recogidos al inicio de un proceso.
TTC
Adobe Analytics
Sesión
Cookie usada para almacenar el tiempo transcurrido entre el evento App Page Visit y App Completed.
TTCL
Adobe Analytics
Sesión
Cookie usada para almacenar el tiempo transcurrido entre el evento LogIn y App Completed.
s_cc
Adobe Analytics
Sesión
Determinar si las cookies están activas
s_hc
Adobe Analytics
Sesión
Cookie usada por Adobe con propositos de analítica.
s_ht
Adobe Analytics
Sesión
Cookie usada por Adobe con propositos de analítica.
s_nr
Adobe Analytics
2 años
Determinar el número de visitas de usuario
s_ppv
Adobe Analytics
Persistente
plugin Adobe Analytics: getPercentPageViewed Determinar el procentaje de página que visualiza un usuario
s_sq
Adobe Analytics
Sesión
Funcionalidades ClickMap/ActivityMap
s_tp
Adobe Analytics
Sesión
Cookie usada por Adobe con propositos de analítica.
s_visit
Adobe Analytics
2 años
Cookie usada por Adobe para saber cunado una sesión se ha iniciado.
Cookies de Publicidad
Permiten que la publicidad que te mostramos sea personalizada y relevante para ti. Gracias a estas cookies no verás anuncios que no te interesen.
Dispones de una publicidad adaptada a ti y a tus preferencias.
Con tu selección pierdes la personalización de la publicidad, solo verás anuncios genéricos.
Denominación
Titular
Duración
Finalidad
OT2
VersaTag
90 días
Cookie de VersaTag usada para almacenar un id de usuario y el numero de visitas del usuario.
u2
VersaTag
90 días
Cookie de VersaTag en la que se almacena el ID del usuario
TargetingInfo 2
MediaMind
1 año
Cookie que sirve para asignar un número unico random que genera MediaMind.
Cookies de Personalización
Estas cookies están relacionadas con características generales como, por ejemplo, el navegador que utilizas.
Dispones de una experiencia y contenidos personalizados.
Con tu selección no podemos ofrecerte una navegación y contenidos personalizados.
Denominación
Titular
Duración
Finalidad
mbox
Adobe Target
9 días
Cookie usada por Adobe Target para hacer test de personalizacion de experencia del usuario.
Parece que estás navegando desde MéxicoEspañaArgentinaPerúColombiaBélgicaChileEEUUFranciaHong KongItaliaPortugalReino UnidoTurquíaUruguayVenezuelaAlemania, así que vamos a mostrarte el contenido personalizado para tu localización. Cambiar
Selecciona el país
Para poder acceder al área privada y sandbox correspondiente, selecciona el país de las APIs que quieres utilizar.
Preferencias de Navegación
Elige el país del que quieres que te mostremos su contenido por defecto.