SVN + Git, una manera de combinarlos y ser feliz.

SVN y Git provienen de dos modelos distintos de control de versiones: el centralizado y el distribuido, en la práctica son similares, sin embargo existen marcadas diferencias que hacen que la elección de cuál usar en un proyecto, dependen de varios factores.

Ventajas y desventajas del modelo centralizado

  • Luce mas simple
  • Existen muchas herramientas para trabajar con repositorios centralizados, ya que llevan mas años y fueron muy difundidos
  • Muchas IDEs tienen soporte completo
  • No pueden haber commits offline
  • Dificultades para trabajar con branchs
  • Dificultades para trabajar en equipos grandes.

Ventajas y desventajas del modelo distribuido

  • Modelo simple de colaboración
  • Permite trabajar offline
  • La instalación es sencilla y hay muchos servicios de hosting
  • Copia completa del repositorio en cada clon
  • Todo el trabajo casi es local.
  • Tiene flujo de trabajo mas complejo, sobre todo en equipos grande, y con diferentes permisos por usuario.
  • Una curva de aprendizaje mas grande

Diferencias principales:

El modo de guardar la historia: Para SVN la historia de un proyecto nunca cambia, sin embargo Git permite modificar commits anteriores usando por ejemplo: git rebase. A pesar de que puedan haber maneras de editar el mensaje de un commit en SVN, esto requiere permisos de administrador, algo que no es recomendable si hay que darle permisos de administrador con equipos de trabajo grande.

Estructura del directorio: Para SVN se deben tener carpetas distintas para trunk, branches, y tags, en Git todo esta en una sola carpeta y Git se encarga de ocultar el master, branches y tags.

Subproyectos: Un subproyecto permite compartir código o módulos entre proyectos, para SVN se usa el svn-external y en git existen los Git submodels, comparten el mismo concepto pero el uso y el flujo de trabajo es el mismo.

Este artículo de Github amplia esta breve explicación de las diferencias: https://help.github.com/articles/what-are-the-differences-between-svn-and-git

¿Por qué combinar SVN y Git? Mi caso de éxito

Hay casos específicos en los cuales su combinación de verdad que resuelve muchos problemas, sobre todo aprovechando que el uso de Git para ramas locales es fantástico.

Actualmente trabajo en Belatrix y por motivos de contrato con el cliente (confidencialidad), no puedo mencionar detalles, nombres, mucho menos información privada del proyecto, sin embargo puedo explicar el flujo de trabajo que usamos y que se puede replicar en otros proyectos.

Mi cliente es una compañía multinacional que tiene un producto muy bueno de banca móvil, completamente configurable y adaptable a los sistemas bancarios actuales, lo que hace que tenga a su vez miles de clientes (entidades financieras) que usan su producto y por lo tanto al final el producto que ayudamos a construir es usado por millones de personas alrededor del mundo,  para lograr y mantener ese éxito tan grande que están teniendo ahora, se necesitan muchas personas involucradas en el desarrollo del producto, decenas de desarrolladores usando los mismos repositorios, las mismas ramas, con diferentes permisos de acceso y demás. Mi cliente ha elegido SVN como gestor de sus repositorios, por diversas razones técnicamente justificables.

A pesar de que la tendencia se da hacia modelos distribuidos de control de versiones (Git y Mercurial en su mayoría), el uso de SVN sigue siendo masivo en muchas empresas y proyectos.

En este proyecto Belatrix lleva aproximadamente 4 años y nuestro equipo en particular lleva un año y medio aproximadamente, al principio mi equipo empezó a utilizar git-svn para manejar ramas locales y funcionaba muy bien, el cliente tenia una rama principal, una rama para el proyecto, una rama para el modulo que estábamos desarrollando, y nosotros gracias a git-svn teníamos ramas para lo que queramos: bugs, User Stories, improvements, cleanups y encontramos un flujo de trabajo muy bueno y simple de mantener.

SVN + GitPara lograr esto usábamos git-svn (https://www.kernel.org/pub/software/scm/git/docs/git-svn.html), todo iba bien hasta que en el lado del SVN se empezó a usar svn-externals, a partir de entonces dejo de funcionar git-svn y si hubiéramos querido forzarlo, hubiéramos complicado el flujo de trabajo y probablemente hubiéramos aumentando las probabilidades a cometer errores.

Es aquí donde encontramos una forma simple de continuar con nuestro flujo de trabajo y este fue un par de cambios en el .gitignore, el flujo de trabajo es como el que describo a continuación:

  • svn checkout <ruta_del_servidor_SVN>
  • git init (en la carpeta donde se hizo el checkout)
  • Agregar .svn/ al .gitignore (para que Git ignore a la carpeta principal del SVN, este es un paso muy importante, de no hacerlo correctamente todo el flujo fallará.)
  • Agregar */.svn/ al .gitignore (para que Git ignore a multiples carpetas).
  • Continuar el desarrollo con Git, creando ramas locales y usarlo como se acostumbra.
  • Actualizar y mantener sincronizado el Git master antes de hacer un commit al SVN
  • Los commits siempre van al Git master para evitar errores y desde el Git master se hacen los commits al SVN.
  • Los updates desde el SVN siempre se hacen al Git master, de manera tal que el master siempre tiene una copia actualizada.

Si te sirve sienteté libre de comentar, sugerir una mejora para este flujo y compartirlo  :)

 

Lo que aprendí, escribiendo para Maestros del Web

Hace dos años tuve la iniciativa de hacer un curso en español sobre Django, uno que me permitiera plasmar lo que aprendí como programador, mi intención de colaborar con la comunidad de programadores y mi experiencia como profesor universitario, me contacté con @cvander y el resultado fue un tremendo éxito, mucha gente escribiéndome al día, cientos de correos electrónicos con muchas consultas, realmente logre mi propósito, el acercar Django a la comunidad hispana a través de Maestros del Web, fue una experiencia estupenda.

Luego de hacer el curso y que se publicará empezaron a aparecer muchos cursos que eran parecidos al mío, en video, audio y con otros ejemplos, en un momento me llego a molestar pues simplemente a veces copiaban el curso le cambiaban el nombre y lo publicaban, pero luego comprendí que es normal que eso suceda y que por el contrario de molestarme lo empecé a tomar como un agradecimiento.

Sin embargo como siempre hay gente que llego a pensar que tenia el derecho de exigirme que les de soporte, que solucione sus errores de codificación, que su trabajo dependía de ello y obviamente lo pedían de mala manera, hay gente que no lee, simplemente copia y pega el código y cree haber aprendido, o incluso gente que tuvo errores simples con sintaxis de python y que insistía en que yo corrija su código.

En los últimos meses he estado recibiendo varios correos con supuestos errores que tiene la guía y que dicen que es malo, sin darse cuenta tal y como esta escrito que la versión que use es la 1.4 y obviamente va a fallar con las nuevas versiones del framework, hay tanta mala onda en esos correos que simplemente me canse de contestarlos, y aquí viene la pregunta que me hizo @shinjiDev

Y pues de verdad que lo intente, escribí algunos capítulos con la versión 1.5, luego no pude concluirlo, mi situación laboral cambio, llegaron mas responsabilidades a mi vida profesional, lo retomé, actualicé y escribí algunos capítulos con la versión 1.6 y nuevamente llegaron mas responsabilidades profesionales, hice un último intento por actualizar lo poco que había escrito para la 1.6.5 y ahora lo veo ya innecesario porque la 1.7 está por salir y realmente no quiero dar falsas esperanzas a aquellos que me siguen escribiendo y pidiendo que actualice la guía, se necesita un gran esfuerzo para cumplir con publicar semanalmente y con una calidad aceptable y capturas de pantalla, con código entendible y depurado sin mencionar que se debe publicar gratis, y lo que vendrá luego ayudar a muchos a solucionar los problemas que puedan tener, a asesorar y a responder correos a los que no leen del todo.

Así que por ahora, pienso aprovechar que esta por salir la 1.7 y refactorizar la estructura de la guía, sacar una nueva versión o porque no convertirlo en un libro, esta vez pienso usar Leanpub me parece una buena opción.

Todo este contexto me ha permitido aprender y dar estos consejos si alguna vez se animan a publicar un curso o guía técnica:

  • Debes tener una estructura ya planificada antes de escribir la primera palabra de la guía, eso te dará una visión general del producto final y te permitirá organizar tus ideas.
  • Debes de tener fechas fijas de publicación, y por lo menos listos dos capítulos para no fallar con la fecha, eso le da seriedad a tu publicación
  • Usa un repositorio de código si va a haber ejemplos, usar tags y branchs son muy buenas ideas.
  • No escribas código en el post, menos uses etiquetas especiales, tienden a desordenarse, algunos lo copiaran sin leer o entender y te lloverán los emails pidiendo ayuda, y la mayoría de errores serán porque copiaron mal, en lugar de ello usa el repositorio o capturas de pantalla con indicaciones (usa skitch)
  • Escribe claramente, si es posible en mayúsculas, que no te haces responsable de dar soporte o asesoría personalizada, créeme te ahorraras problemas y malos entendidos, sobre todo evitaras conflictos con gente que cree que todo es gratis y que hasta te pueden llegar a insultar e inmerecidamente llamarte estafador.
  • Escribir una guía técnica es un estupendo ejercicio del cual puedes mejorar tus habilidades de comunicación.
  • Acompañar la guía técnica con videos puede resolver muchas dudas y evitar que tengas que responder muchos correos con las mismas explicaciones.
  • Separa un tiempo a la semana para responder correos, y comentarios y no te excedas de ese tiempo, sino se convertirá en una pesadilla y algo más de que preocuparse.
  • Intenta escribir porque también, encontraras a estupendas personas que compartirán contigo ideas y puedes armar una buena red de contactos y generar comunidad.

Empezaré a trabajar desde ahora en la nueva versión de esta guía, que espero que se convierta en un libro.

Actualización: Aquí está disponible el PDF del Curso de Django en Maestros del web

Patrones de interfaces de usuarios para móviles

Cuando se tiene una idea de una aplicación móvil o una interfaz especial para web móviles (no responsive, sino especificamente construida para movil, algo como los que tienen el subdominio m.ejemplo.com), empezamos a imaginar como debería lucir en el móvil, la distribución de componentes y otros detalles claves, que determinan el éxito o fracaso de una aplicación. Es en esos momentos en los cuales es ideal consultar galerías y patrones de interfaces, que presentan soluciones comunes a las que el usuario ya esta acostumbrado y que permite. Estas son las fuentes de inspiración que a mi parecer tienen la mayor cantidad de patrones:

pttrns.com

Especializada en patrones de interfaces de usuarios para iPhone y iPad, posee mas de 2000 patrones. pttrns

 androidpatterns.com

Esta más enfocado a patrones de interacción en interfaces de usuarios para Android. androidpatterns.com

mobiledesignpatterngallery.com

La galería relacionada al libro de Theresa Neil sobre patrones de diseño móvil de editorial O’Reilly, $9.99 como ebook para kindle que valen la pena. mobiledesignpatterngallery.com

 android.ux

Patrones de diseño para android, son diversos screenshots de interfaces existentes.

androidux.com

mobile-patterns.com

Diversos patrones de diseño para iPhone y Android mobile-patterns.com

uiparade.com

Recursos visuales que se pueden descargar y también comprar, algunos muy creativos e innovadores, definitivamente gran fuente de inspiración uiparade.com

 inspired-ui.com

Ademas de tener patrones para iPhone y Android, también posee una categoría para iPad. inspired-ui.com

 

lovelyui.com

Es mas una colección de elementos visuales, pero que también valen de inspiración

lovelyui.com

 

cocoacontrols.com

Aqui puedes encontrar elementos visuales al igual que el anterior, pero orientados a iOS y OS X, incluyendo una clasificación por licencias.

 

cocoacontrols.com

 

 

Estas son algunos de los mejores recursos online que se pueden utilizar para buscar inspiración y patrones que funcionan.

Happy UI designing ;)

El poderoso tablero Kanban en la gestión de tareas

kanban-board-simpleUno de las metodologías con mayor difusión y aplicación en diversas áreas profesionales es Kanban para la gestión de tareas y trabajo en progreso, aquí un video si es que no estas muy al tanto de que es:

El tablero kanban es una herramienta que ayuda a implementar la metodología del mismo nombre en un proyecto, este tablero es una variación de lo que son las famosas tarjetas kanban, usadas en producción y almacenaje, que van adjuntadas al producto y van trasladándose etapa por etapa (aquí un ejemplo de las tarjetas):

kanban-cards-dt915-lg

Y aquí un video de como se usa las tarjetas Kanban en una línea de producción:

Existen muchos tipos de tableros Kanban, que pueden tener columnas para diversos propósitos (pendientes, pruebas, desarrollo, pendientes de aprobación, realizadas, entre otras) y puede incluir subcolumnas, con diversos parámetros adicionales (capacidad máxima, prioridades, limitaciones, alertas) y cualquier otro tipo de indicador que permita hacer visible el trabajo en progreso.

Esta flexibilidad en el tablero kanban lo convierte en algo confuso al principio e incluso tedioso que puede convertirse en una resistencia al cambio sobre todo cuando se quiere utilizar por primera vez.

Cómo empezar a usar el tablero Kanban en pasos sencillos

  • Empieza usando la versión más simple de todas: tres columnas, una para las tareas pendientes, otra para las que están en progreso y una tercera para las terminadas
  • Es mejor empezar con un tablero físico, que se puede confeccionar con materiales sencillos: plumones, hojas, cintas. Puede ser de tamaño personal que pueda caber en tu escritorio, en una pizarra, o incluso en una ventana, para ello las tarjetas pueden ser esas notas adhesivas de colores.
  • Si vas a empezar a usar en tus tareas personales o tareas de equipo concéntrate en poner todas las tareas pendientes, si durante el desarrollo de alguna tarea, se te viene a la mente alguna otra, inmediatamente agrégala a tu columna de pendientes.
  • Ordena las tareas pendientes por prioridad, puedes usar colores si se te hace más simple o puedes ponerles algún numero en las esquinas que indique la prioridad.
  • Cada vez que vas a iniciar con una tarea, coloca la nota en la columna de “En progreso”, puedes aprovechar la nota para poner algunos criterios de aceptación, es decir que cosas debe cumplir la tarea para avanzar a la siguiente columna (en esta versión simple, que cosas tienen que cumplirse para considerar que la tarea esta concluida).
  • Evita llenarte de tareas “en progreso”, buscando siempre tener esta columna vacía, si es que una tarea pasa mucho tiempo en esa columna, indica que es una tarea que probablemente tenga que volver a la columna de pendientes o apresurarse en concluirla.
  • Una vez concluida la tarea y haberte asegurado que todos los criterios para considerarla terminada se hayan cumplido, trasládala hacia la columna de concluidas, esto servirá para medir cuantas tareas ya fueron terminadas y visualizar tu progreso.
  • Aprovecha las notas para llevar un registro del tiempo en que te demoro en terminar una tarea, eso te ayudará a evaluarte y buscar mejorar continuamente tus tiempos.
  • No busques una herramienta informática para gestionar un tablero kanban, hasta que no tengas la costumbre de usarlo, no te servirá de nada tener una plataforma mas que atender si no estas acostumbrado al tablero, lo hará más complejo y lo abandonaras rápidamente, sin aprovechar su potencial.

Estas son mis recomendaciones para empezar a trabajar con el tablero Kanban, es importante notar de que este tablero no es excluyente y que puede ser usado con cualquier metodología de desarrollo o gestión de proyectos, incluso se puede utilizar para tareas del hogar o para tareas personales.

Nota: Si buscas una herramienta en línea para gestionar Kanban, hay muchas opciones de pago y gratuitas, elegir una para el trabajo en equipo dependerá del contexto, así que prefiero no hacerlo. Pero si se desea aplicar para contexto personal o pequeños proyectos no esta mal darle un vistazo a Trello que incluso tiene una aplicaciones para el smartphone.

Actualización: Este es un ejemplo de cómo se gestiona un tablero kanban, en un sprint de dos semanas, en un video de pocos segundos

Happy task management ;)

Los principios ágiles

Al hablar de metodologías ágiles de desarrollo de software, lo primero que a muchos se le viene a la mente es el manifiesto ágil (para mi al puro estilo de Los Simpsons).

agile-is-a-cult-manifesto

Pero a unos cuantos se les viene a la mente que este manifiesto se ve soportado por los principios, principios que a veces son difíciles de entender si es que no se han practicado o haber aplicado en situaciones reales.

He preparado el siguiente video con mis puntos de vista y mi experiencia con los principios ágiles (decidí hacer un video, porque un artículo me hubiera quedado muy largo).

Otro video muy interesante es el que preparo @pablitux vale la pena verlo.

Y esta es la fuente oficial de los principios ágiles (en español): Principios del Manifiesto Ágil

Happy Coding :)