• Navegadores:
  
  • para Linux: Epiphany 2.14, Firefox 1.5, Firefox 2.0, Galeon 2.0, Iceweasel 2.0, Konqueror 3.5, NetFront 3.2, Opera 9.24, Opera 9.5
  • para Windows: Firefox 1.5, Firefox 2.0, MSIE 5.5, MSIE 6.0, MSIE 7.0, Opera 9.24, Safari 3.0.
  • para Mac OS: Firefox 2.0, Safari 1.3, Safari 2.0, Safari 3.0
    
• Anchos de pantalla: 640, 800, 1024, 1280, 1400 y 1600 pixels.
• Profundidad de color: 8, 16, 24 y 32 bits por pixel.
• Javascript: deshabilitado, habilitado, v1.3, v1.5, v1.6, v1.7, v2.0
• Java: deshabilitado o habilitado.
• Flash: deshabilitado o habilitado.

1. Comenta a varios niveles

• En cada clase, incluir una breve descripción, su autor y fecha de última modificación
• Por cada método, una descripción de su objeto y funcionalidades, así como de los parámetros y resultados obtenidos

2. Usa párrafos comentados

  ...
  

  // Comprobamos si todos los datos
  // son correctos
  foreach (Record record in records)
  {
     if (rec.checkStatus()==Status.OK)
     {
        ...
     }
  }
  

  // Ahora pasamos a realizar las
  // transacciones
  Context ctx = new ApplicationContext();
  ctx.BeginTransaction();
  ...

3. Tabula por igual los comentarios de líneas consecutivas

  const MAX_ITEMS = 10; // Número máximo de paquetes
  const MASK = 0x1F;    // Máscara de bits TCP

4. No insultes la inteligencia del lector

   if (a == 5)     // Si a vale cinco, ...
      counter = 0; // ... ponemos el contador a cero
   ...

5. Sé correcto

6. No pierdas el tiempo

7. Utiliza un estilo consistente

8. Para los comentarios internos usa marcas especiales

  int calcula(int x, int y)
  {
      // TODO: implementar los cálculos
      return 0;
  }

9. Comenta mientras programas

   public void ProcesaPedido()
   {
      // Comprobar que hay material
      // Comprobar que el cliente es válido
      // Enviar la orden a almacén
      // Generar factura
   }

10. Comenta como si fuera para tí mismo. De hecho, lo es.

"tan pronto como una línea de código sale de la pantalla y volvemos a ella, estamos en modo mantenimiento de la misma"

11. Actualiza los comentarios a la vez que el código

12. La regla de oro del código legible

  Console.WriteLine("Resultado: " +
    new Calculator()
          .Set(0)
          .Add(10)
          .Multiply(2)
          .Substract(4)
          .Get()
  );

13. Difunde estas prácticas entre tus colegas

I. ¿Hablamos de botones con lógica exclusivamente en cliente?

  <input id="Button1" type="button" value="button"
         onclick="hacerAlgo();" />

II. Anular el postback en un botón de servidor

...
<asp:Button ID="Button1" runat="server"
            Text="Pulsa"
            OnClientClick="return comprueba();" />
...
<script type="text/javascript">
   function comprueba() {
        return confirm("Confirme el postback");
   }
</script>

III. Anular la posibilidad de envíos múltiples

<asp:Button ID="Button2" runat="server"
     Text="Pulsa"
     OnClientClick="this.disabled=true"
     UseSubmitBehavior="False"/>

...
<form id="form1" runat="server" onsubmit="deshabilita()">
...
<script type="text/javascript">
    function deshabilita()
    {
        var btn = "<%= Button1.ClientID %>";
        if (confirm("Confirme postback"))
        {
            document.getElementById(btn).disabled = true;
            return true;
        }
        return false;
    }
</script>

• Motores de bases de datos SQL Server, SQL Server 2005, SQL Server 2005 Compact Edition, Oracle, MySQL, Interbase, IBM DB2, Sybase, Informix, Ingres, Mimer SQL, Lightbase, Postgre SQL, Paradox, Firebird, AS/400 (iSeries), Pervasive, SQLBase, Progress y Caché.


• Archivos de datos Excel 2007, Excel, texto plano, Access 2007, Access, Visual FoxPro / FoxPro 2.x DBF / FoxPro, SQLite y Filemaker.


• Otras fuentes, como MS Project, Active Directory, Exchange, Lotus Notes, DSN y UDL.

class @class
{
  public static void @static(bool @bool)
  {
    if (@bool)
      System.Console.WriteLine("true");
    else
      System.Console.WriteLine("false");
  }
}

    // Retorna la suma de a y b
    public int multiplica(int a, int b)
    {
       ...

    if (a > 5)       // Si a es mayor que cinco, ...
       counter = 0;  // ... ponemos el contador a cero
    ...

    // Si x es true, retorna a+b
    // Si no, retorna a-b
    public int calcula(int a, int b)
    {
       ...

"Cualquier tonto puede escribir código que entienden las computadoras. Los buenos programadores escriben código que entienden las personas"

• el orgullo del programador ("no me hacen falta comentarios para entender lo que hace cualquier código", "yo escribo código que entiende cualquiera"). No te engañes, un código medianamente complejo te llevará tiempo entenderlo en cuanto hayan pasado unos meses incluso a tí mismo, así que imagina a otro desarrollador.
• la pereza y procrastinación ("ya comentaré el código más adelante"). No te engañes, no lo harás; además, se estima que el tiempo necesario para añadir comentarios útiles a un código se duplica (como mínimo) si no se realiza en el momento de la codificación.
• la excusa del deadline ("el proyecto va demasiado apurado como para ponerme a comentar el código"). No te engañes, los minutos de tardarás en comentar apenas afectarán a los plazos, y sí añadirán mantenibilidad al sistema.

"comentar el código es como limpiar el cuarto de baño; nadie quiere hacerlo, pero el resultado es siempre una experiencia más agradable para uno mismo y sus invitados"

  Calculator calc = new Calculator();
  calc.Set(0);
  calc.Add(10);
  calc.Multiply(2);
  calc.Subtract(4);
  Console.WriteLine("Resultado : " + calc.Get());

  Console.WriteLine("Resultado: " +
    new Calculator().Set(0).Add(10).Multiply(2)
                    .Substract(4).Get()
  );

  new Surface()
    .Clear()
    .Fill("white")
    .CreateText()     
       .SetMessage("Hi, all!")
       .SetColor("blue")
       .Draw()
    .CreateCircle(100, 100, 10)
       .Fill("green")
       .Draw()  
    .Border("red")
    .Draw() 

• en la primera estaría el formulario de introducción de criterios.
• en la segunda podríamos simplemente tomar los parámetros de la anterior y mostrar un listado con los resultados obtenidos, o bien un mensaje de información si no hay coincidencias.
• en la tercera podríamos montar una ficha con los datos detallados de un elemento, que habría sido seleccionado por el usuario en la página anterior.

if (PreviousPage != null)
{
  TextBox txt =
    (TextBox)PreviousPage.FindControl("TextBox1");
  Label1.Text = txt.Text; // Por ejemplo
}

<%@ PreviousPageType VirtualPath="~/PaginaOrigen.aspx" %>

public string Texto
{
   get {return txtTexto.Text; }
}

if (PreviousPage != null)
{
  Label1.Text = PreviousPage.Texto; // Por ejemplo
}

• Separación clara de lógica, presentación y control.
• Utilización de URLs limpias y amigables.
• Control absoluto sobre el marcado y emisión de XHTML puro.
• Extensibilidad total, todos los componentes pueden ser reemplazados por otros de terceros.
• Ventajas sobre Monorail (o incluso Ruby on Rails), como la perfecta integración con VS2008 (intellisense, plantillas, depuración...), o el uso de parte de la infraestructura ASP.NET (aunque se abandonen los postbacks).

La funcion de script que usas para añadir varias funciones al evento onload esta bien si son llamadas sin parametros. La duda es cómo podría hacer lo mismo si la función que tiene que correr en el inicio recibiera un parametro de entrada.Siguiendo tu ejemplo, me gustaria usar algo como:

addOnLoad(init1(3));
addOnLoad(init2(4));

La obvia

   <body onload="alert('hola 1'); alert('hola 2');">

La fácil

   // Asociamos las funciones al
   // evento OnLoad:
   addOnLoad(miFuncion1);
   addOnLoad(miFuncion2);

   function miFuncion1() {
      alert('hola 11');
      alert('hola 12');
   }
   function miFuncion2() {
      alert('hola 2');
   }

La "pro"

   // En este código se hace lo mismo que
   // el ejemplo anterior:

   addOnLoad(
       function() {
          alert('hola 11');
          alert('hola 12');
       }
   );
   addOnLoad( function() { alert('hola 2'); } );

• Un ensamblado listo para ser utilizado en nuestros proyectos, o para añadirlo a la caja de herramientas (Toolbox) del entorno de desarrollo.
• Una web de demostración, en la que podéis haceros una idea de la utilidad del componente. No hay una demo on-line debido a que en los servidores donde se encuentra no existe esta posibilidad, cuando encuentre un alojamiento apropiado la pondré para que pueda verse en vivo y en directo.
• La solución VS2005 con el código fuente completo de ambos.

• Web del proyecto NiftyDotNet (alojado en Google code).
• Blog del proyecto, en inglés (o algo parecido ;-))

<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Prueba de scripting</title>
</head>
<body onload="alert('OnLoad()');">
    <h1>Prueba Scripting</h1>
</body>
<script type="text/javascript">
    alert('Script en HTML');
</script>
<script type="text/javascript" src="script.js"></script>
</html>

• en el elemento <body> he incluido un atributo onload="alert('onload');".
• he añadido un bloque script con una única instrucción alert('script HTML');
• he añadido también una referencia a un archivo script externo, en el que sólo hay una instrucción alert('archivo .js');

• Se ejecuta en primer lugar el código incluido en los bloques <script> .
• Si hay varios bloques de script, se ejecuta el código incluido en cada uno de ellos, siguiendo del orden en el que están declarados.
• No importa si son scripts incrustados en la página o si se encuentran en un archivo .js externo, se ejecutan cuando le llega el turno según el orden en el que han sido definidos en la página, es decir, la posición del tag <script> correspondiente.
• Por último, se ejecuta el código del evento onload del cuerpo de la página. De hecho, este evento se ejecuta una vez se ha cargado y mostrado la página al usuario, es el último en tomar el control.

function addOnLoad(nuevoOnLoad) {
   var prevOnload = window.onload;
   if (typeof window.onload != 'function') {
      window.onload = nuevoOnLoad;
   }
   else {
      window.onload = function() {
          prevOnload();
          nuevoOnLoad();
      }
   }
}

// Las siguientes llamadas enlazan las
// funciones init1() e init2() al evento
// OnLoad:

addOnLoad(init1);
addOnLoad(init2);

private string saludar(string nombre)
{
  if ("".Equals(nombre))
    return "No saludo a nadie";
  else
    return "Hola, " + nombre;
}

private string saludar(string nombre)
{
  if (string.IsNullOrEmpty(nombre))
    return "No saludo a nadie";
  else
    return "Hola, " + nombre;
}

public enum EstadoSemaforo
{
    Rojo, Amarillo, Verde
}

[Flags]
public enum LedStatus
{
   BloqMays=1,
   BloqNum=2,
   BloqDespl=4,
   All=BloqMays | BlogNum | BloqDespl,
   None = 0
}

public enum TipoDeUsuario
{
   Anonimo = 0,
   Registrado = 1,
   Gestor = 2,
   SuperUsuario = Registrado | Gestor;
}

LedStatus leds =  LedStatus.BloqMays | LedStatus.BloqNum
Console.WriteLine(leds);

// la siguiente instrucción activa el
// BloqMays, pero desactiva todos los demás

estado = LedStatus.BloqMays;

// las siguientes instrucciones
// activan el bit 0 (BlockMays)
// dejando intactos los demás leds:

estado = estado | LedStatus.BloqMays;
estado |= LedStatus.BloqMays;

if(estado==LedStatus.BloqMays)
   // sólo se cumple si está
   // activo únicamente BloqMays

if ( (estado & LedStatus.BloqMays) != 0)
   // se cumple cuando el BloqMays
   // está activo, independientemente del resto

string sql =
@"SELECT product_name,
       product_details,
       total_rows
  FROM (
        SELECT product_name,
               product_details,
               total_rows,
               rownum row_counter
        FROM   (
                SELECT product_name,
                       product_details,
                       count(*) OVER () total_rows
                FROM   products
                WHERE product_name
                        like '%" + pattern + @"%'
                ORDER BY product_name
               )
       )
  WHERE row_counter between v_start_row and v_end_row;";

<?php
echo <<<EOT
function AddCss()
{
   var l=document.createElement('link');
   l.setAttribute('type','text/css');
   l.setAttribute('rel','stylesheet');
   l.setAttribute('href','styles.css');
   document.getElementsByTagName('head')[0].appendChild(l);
};
EOT;
?>

string script =
@"function AddCss()
{
    var l=document.createElement('link');
    l.setAttribute('type','text/css');
    l.setAttribute('rel','stylesheet');
    l.setAttribute('href','styles.css');
    l.setAttribute('media','screen');
    document.getElementsByTagName('head')[0].appendChild(l);
}";
Response.Write(script);

• Soporte nativo para TDD (¿qué diantres es esto?) en los Controladores.
• Vistas basadas en ASPX, sin viewstate ni postbacks.
• Soporte para enlaces otros motores como MonoRail.
• Soporte para contenedores IoC (¿ein?) y DI (¿y esto qué es?).
• Control absoluto sobre las URLs y la navegación. Éstas seguirán un modelo común, algo similar a: "/Ruta/Acción/Param1/Param2... ", que se mapearán hacia la acción oportuna del Controlador asignado.
• Separación de la capa de negocio de la de presentación, como buen MVC.
• Integración total en ASP.NET, sin traumas. De hecho, la llegada de esta tecnología no implica, ni por asomo, la desaparición de los conocidos y utilizados Webforms actuales, ambos modelos podrán convivir incluso en la misma aplicación.
• Soporte para lenguajes estáticos como C++, C#, o VB.Net y dinámicos como Javascript, Ruby o Python.

<%@ Page Language="C#" MasterPageFile="~/Site1.Master" 
    AutoEventWireup="true" CodeBehind="WebForm1.aspx.cs"
    Inherits="PruebasVariadas.WebForm1"
    Title="Página sin título" %>

// C#:
protected override void OnPreInit(EventArgs e)
{
  if (DateTime.Now.Hour % 2 == 0)
    this.MasterPageFile = "~/Maestra1.master";
  else
    this.MasterPageFile = "~/Maestra2.master";

  base.OnPreInit(e);
}


' VB.NET:
Protected Overrides Sub OnPreInit(ByVal e As System.EventArgs)
  If DateTime.Now.Second Mod 2 = 0 Then
    Me.MasterPageFile = "~/Maestra1.master"
  Else
    Me.MasterPageFile = "~/Maestra2.master"
  End If
  MyBase.OnPreInit(e)
End Sub