Archivo para abril, 2009

Sandcastle, genera y presenta la documentación XML de tu código.

Posted in Aplicaciones, Microsoft on abril 27, 2009 by César Intriago

 

sandcastlelogo_jpg En estos días he estado trabajando parcialmente en un proyecto de desarrollo de una API para un CMS, de tal forma que podamos extender y automatizar ciertas funcionalidades desde aplicaciones .Net como ASP.NET, Silverlight o Windows Client.

Como una forma de ayudarme a organizar el código y a cualquiera que use mi código, agregué comentarios XML a mis clases en C#, tratando de poner la descripción de los métodos al estilo de las clases de .Net. Esta interesante característica de documentación ofrece ayuda contextual en línea cuando alguien usa un método dentro de Visual Studio  (a manera de tool tips). El compilador de C# es capaz de extraer estos comentarios y generar un archivo XML usado por Visual Studio, pero también puede ser usado por otras aplicaciones como el caso de Sandcastle que se encarga de leer este tipo de archivos XML y aplicar reflexión al proyecto relacionado para extraer metadatos adicionales para generar una documentación completa al estilo MSDN.

Sandcastle es de Microsoft, gratis y de código abierto, pueden descargarlo desde el sitio en CodePlex. Adicionalmente les recomiendo descargar el Sandcastle Help File Builder que es la interfaz gráfica para la aplicación Sandcastle. Su forma de uso es simple y al estilo del extrañado NDoc, les dejo algunas capturas de pantalla de esta herramienta y cómo se ve la documentación generada:

sc1 sc2 Imagen 1

Anuncios

¿Cómo comentar nuestro código?

Posted in Opinion on abril 20, 2009 by César Intriago

 

/* ******************************************************

Este post trata de un tema muy importante que muchas veces pasamos por alto los programadores, el poner comentarios a nuestro código. Ya sea para nosotros o para otro que le toque la tarea de mantener nuestros programas, es de suma importancia y ayuda el agregar los comentarios lo suficientemente explicativos para entender lo que hace un método en particular, mmmm….No, ya en serio esto se trata de los mejores comentarios con los que me he topado el día de hoy domingo, la lista original y completa la pueden encontrar en StackOverflow.com , un ejemplo:

//
// Dear maintainer:
//
// Once you are done trying to ‘optimize’ this routine,
// and have realized what a terrible mistake that was,
// please increment the following counter as a warning
// to the next guy:
//
// total_hours_wasted_here = 16
//

Traducción 😎

//
// Estimado desafortunado:
//
// Una vez que hayas terminado de intentar optimizar esta rutina,
// y te hayas dado cuenta el terrible error que fue,
// por favor incrementa el siguiente contador como advertencia
// para el siguiente tipo:
//
// total_horas_desperdiciadas_aquí = 16
//

NOTA: Todos los comentarios citados aquí son propiedad de sus respectivos programadores.

****************************************************** */

// TODO: Ingrese su comentario luego de esta línea.

ASP.NET MVC eBook Gratis

Posted in ASP.NET, Microsoft, Noticias, Tutorial on abril 8, 2009 by César Intriago

 

bookcover1_6CAECF94Más buenas noticias de ASP.NET MVC !!. Scott Guthrie nos trae este eBook con un tutorial que cubre el desarrollo de NerdDinner, una aplicación ASP.NET MVC. Es un excelente material para aprender más de este tema y punto de referencia sobre la arquitectura de las aplicaciones.

<< Descargar el libro

A primer vistazo se explica brevemente un poco de la estructura de proyectos en MVC, y luego manos a la obra, código, código y más código!!.

Algo además interesante de mencionar es que el eBook se distribuye bajo la licencia Creative Commons.

Este fin de semana será el momento para darle una buena leída y empezar a escribir código, tocará darle descanso al Halo3 este fin de semana. Thanks Scott !.

Otros enlaces recomendados sobre material relacionado a ASP.NET MVC:

  1. http://www.asp.net/learn/mvc/#MVC_Overview
  2. http://aspnet.codeplex.com/Wiki/View.aspx?title=MVC&referringTitle=Home

Quiero uno de estos !

Posted in Apple, Opinion on abril 7, 2009 by César Intriago

iPod Touch de 16GB !!.

ipodtouch_image3_20080909

Tengo entre ceja y ceja este juguetito, estoy esperando que salga la nueva versión (estimo que por septiembre). Entre las características que me hacen optar por el iPod Touch están:

  1. Cliente de correo.
  2. Cliente de IM
  3. Navegador Web
  4. Reproduce video
  5. Música + Genius
  6. Fotos
  7. Abrir PDFs
  8. WiFi

Para los que piensen que mejor debería comprar un iPhone, y no es que le haga mala cara al teléfono de la manzana, PERO en temas de celulares prefiero mas pequeños, que puedan ser lanzados al suelo, rayados, robados, llevados a todo lado en el bolsillo junto con los sueltos.

Nuevo sitio Web de Oshyn, Inc.

Posted in Noticias on abril 7, 2009 by César Intriago

No hace mucho acabamos de lanzamos nuestro nuevo sitio Web (Oshyn, Inc.), un importante rediseño visual con un estilo más moderno,  nuevo contenido y mayor información de interés para clientes y la comunidad. Los invito a que lo conozcan:

Oshyn-New

http://www.oshyn.com

Ya está disponible ASP.NET MVC

Posted in ASP.NET, Microsoft, Noticias on abril 4, 2009 by César Intriago

Finalmente fue liberada hace pocos días la versión final de ASP.NET MVC la cual pueden descargar desde la página de ASP.NET MVC:

http://www.asp.net/mvc/

Ya lo tengo instalado y la probaré en los siguientes días, antes había trabajado con otro patrón de diseño: el MVP que me pareció muy bueno; ahora voy a probar el ASP.NET MVC a ver que tal, hay buenos ejemplos, videos y documentación en la página oficial.

ASP.NET MVC

De MVC puedo decir que facilita mucho el tema de SEO (Search Engine Optimization) para tener URLs “amigables” y mas control en la parte del front-end.

¿Problemas al instalar SQL Server 2008 ?

Posted in Aplicaciones, Errores, Microsoft, Tutorial on abril 4, 2009 by César Intriago

El día de hoy descargué la versión Express de SQL Server 2008, pero al momento de la instalación esta terminaba con un error, el link de soporte indicaba que debía remover el SQL Native Client e intentarlo nuevamente, así que fui a la ventana de “Agregar o Quitar Programas” lo removí, intenté nuevamente la instalación y… error otra vez, el mismo mensaje. Hmmm.. dando una vistazo al LOG de instalación, este indicaba que el problema estaba realmente en el componente MSXML 6, regresé a “Agregar o Quitar Programas” para intentar remover el MSXML6 SP2, pero recibía otro mensaje de error que imposibilitaba quitarlo.

Buscando un poco por Internet, encontré la solución, resulta que con Windows XP Sp3 el SMXML6 SP2 se bloquea y no se puede remover, cuando SQL Server 2008 intenta instalar la versión anterior incluida en el instalador, se genera el error descrito anteriormente. La solución fue descargar “Windows Installer Clean Up” y remover el MSXML SP2, luego volver a instalar SQL Server 2008 y listo, la instalación fue exitosa.

Si tienen un ambiente con Windows XP SP3 y están con problemas similares de instalación de SQL Server 2008, prueben lo que les cuento, les podría solucionar su problema.