Foros del Web » Creando para Internet » Diseño web »

la mejor forma documentar el codigo, cual ¿?

Estas en el tema de la mejor forma documentar el codigo, cual ¿? en el foro de Diseño web en Foros del Web. la memoria resulta ser muy fragil por lo tanto se pueden olvidar codigos hechos, dificultad para realizar más de una tarea a la vez, dificultad ...
  #1 (permalink)  
Antiguo 02/03/2010, 14:06
 
Fecha de Ingreso: agosto-2008
Mensajes: 587
Antigüedad: 9 años, 4 meses
Puntos: 6
la mejor forma documentar el codigo, cual ¿?

la memoria resulta ser muy fragil por lo tanto se pueden olvidar codigos hechos, dificultad para realizar más de una tarea a la vez, dificultad para resolver problemas, tardar más tiempo para llevar a cabo actividades mentales más difíciles, etc.

la mejor solución: es para es documentar el código.

cual es la mejor forma para documentar nuestro código personal ¿?

Eh probado con word pero me tira una lineas rojas diciendo que no es valida la escritura, hasta se toma el descaro de ponerme las letras con mayúscula o cambiando palabras sin mi permiso, lo cual me cambia el código sin querer queriendo, la ventaja de usar word que permite poner imágenes, letras mas decentes, etc.

lo otro es usar block de notas, lo deja todo bien la escritura queda tal cual la deja uno, pero no se puede poner imágenes. la letra queda por defecto sin formato, cuando se tienes muchos bloc de notas queda el desorden.

alguna idea para mejorar la forma de documentar el código ?. cual usas tu ?.
  #2 (permalink)  
Antiguo 02/03/2010, 18:17
 
Fecha de Ingreso: enero-2009
Mensajes: 455
Antigüedad: 8 años, 10 meses
Puntos: 11
Respuesta: la mejor forma documentar el codigo, cual ¿?

pues la mejor forma a mi entender es en el mismo código, aunque quiza tenga la desventaja de que el archivo resultante sea un poco mas grande y posiblemente tarde mas tiempo en cargar (hablando de código para una web), otra opcion es replicar el mismo codigo y comentar linea por linea, no se me ocurre otra forma de comentar efectivamente el código, aunque siempre es bueno, tener un word con toda la documentación y requerimientos y demás, dale una leida a ITIL como mejores practicas

saludos
  #3 (permalink)  
Antiguo 02/03/2010, 21:47
Avatar de berthely  
Fecha de Ingreso: junio-2008
Ubicación: VHSA Mexico
Mensajes: 453
Antigüedad: 9 años, 5 meses
Puntos: 9
Respuesta: la mejor forma documentar el codigo, cual ¿?

Te mostraté, para este ejemplo buscaré un ejemplo de javascript en internet

ejemplo fuente: http://javascript.mis-algoritmos.com/1

Asi se vé antes de comentar:

Código:
<script language="JavaScript">
<!--
var id,pause=0,position=0;
function scorrevole() {
var i,k,msg="Mensaje bla bla bla bla bla";
k=(100/msg.length)+1;
for(i=0;i<=k;i++) msg+=" "+msg;
document.form2.scorrevole.value=msg.substring(position,position+100);
if(position++==100) position=0;
id=setTimeout("scorrevole()",100); }
//-->
</script>
Despues:

Código HTML:
<script language="JavaScript">
<!--
//variables de trabajo
var id,pause=0,position=0;

//funcion numero uno, aqui
function scorrevole() {
   var i,k,msg="Mensaje bla bla bla bla bla";
   k=(100/msg.length)+1;
   
   //ciclo for
   for(i=0;i<=k;i++) msg+=" "+msg;
   
   //cambiar valores
   document.form2.scorrevole.value=msg.substring(position,position+100);

   //sentencia if
   if(position++==100) position=0;
      id=setTimeout("scorrevole()",100);
   }
//-->
</script> 
Basicamente lo que hago es dejar un espacio en blanco antes de uniciar una línea de comentario, y no dejar espacion de saltos de linea sin poner comentario.
  #4 (permalink)  
Antiguo 02/03/2010, 22:20
 
Fecha de Ingreso: marzo-2010
Mensajes: 13
Antigüedad: 7 años, 9 meses
Puntos: 1
Respuesta: la mejor forma documentar el codigo, cual ¿?

También podrias tener una cuenta en un servicio como http://snipt.net o http://snipplr.com, sitios que permiten almacenar código con etiquetas, descripciones, etc.
  #5 (permalink)  
Antiguo 02/03/2010, 23:55
Avatar de Carlangueitor
Moderador ლ(ಠ益ಠლ)
 
Fecha de Ingreso: marzo-2008
Ubicación: México
Mensajes: 9.968
Antigüedad: 9 años, 8 meses
Puntos: 1314
Respuesta: la mejor forma documentar el codigo, cual ¿?

Yo he usado una Herramienta que basada en Adobe AIR (osea que te vale para cualquier S.O) se llama Snippely, guarda trozos de código y los puedes usar cuando quieras:

http://code.google.com/p/snippely/

Saludos
__________________
Grupo Telegram Docker en Español

Etiquetas: documentar, mejoras, formulario
Atención: Estás leyendo un tema que no tiene actividad desde hace más de 6 MESES, te recomendamos abrir un Nuevo tema en lugar de responder al actual.
Respuesta




La zona horaria es GMT -6. Ahora son las 22:52.