Página 1 de 1

Guía básica para escribir tus mensajes en el foro

NotaPublicado: 2009-07-14 16:34 @732
por kidd
Hemos recopilado una lista de puntos básicos que se habrían de seguir para escribir de manera correcta un nuevo mensaje en el foro.

1. Buena ortografía y gramática

Lo que escribimos va a ser nuestra carta de presentación; si escribes sin mayor cuidado en la ortografía y gramática, lo más seguro es que dejarás una mala impresión sobre ti.

Aún siendo programadores nos debemos de regir sobre reglas de lenguaje; si el compilador de Perl se va a quejar cuando no ponemos una coma en su lugar, el mismo cuidado debemos de poner cuando escribimos en español.

Intenta también no abusar de las palabras inglesas, aunque sean comúnmente aceptadas en informática. Si existe una palabra en español equivalente siempre es mejor que la inglesa.

2. Usar palabras completas

¿Realmente tenemos tan poco tiempo que debemos de prescindir de letras de una palabra? Es muy molesto tener que, aparte de tomar el tiempo de contestar una pregunta, tener que tomar otro tanto de tiempo en descifrar la pregunta misma.

Así que olvida aquellos mensajes de:

hla com estn?

Nos gustan los retos, pero preferimos un simple:

Hola, ¿cómo están?

3. Describe lo más posible tu problema

Si desde tu primer mensaje describes lo más detallado posible el problema que tienes, la respuesta te llegará mucho más rápido.

Algunos de nosotros tenemos el poder de leer mentes, pero preferimos no usarlos en el foro :wink:

4. Selecciona correctamente tu foro

Hemos dividido el sitio en foros para facilitar la búsqueda y resolución de problemas. Tómate el tiempo de escoger correctamente el foro más apropiado para tu mensaje, si eres de nivel Básico, no pongas mensajes en el foro de Experto, si preguntas sobre HTML no pongas el mensaje en Programación.

Además, siempre es preferible crear un hilo de discusión nuevo antes que poner un nuevo mensaje en un hilo muy viejo y/o saturado de contestaciones. Si el problema que vas a plantear es nuevo, es siempre preferible iniciar un nuevo hilo, aunque existan hilos de discusión parecidos o que traten de los mismos temas.

5. En el foro no se hacen las cosas por ti

Una cosa es ayudar, y otra muy diferente es hacer todo por ti. Cuando pongas tu mensaje, muestra que has hecho el esfuerzo de investigar a intentar solucionar tu problema; si así lo haces, con más gusto se te ayudará.

Olvida las peticiones tipo: "¿Alguien me puede hacer un script que haga X?"

6. Formatea correctamente tu mensaje

Es muy importante que tu mensaje sea fácil de leer y entender, para ellos nos hemos esforzado en brindar herramientas que logran esto.

En la parte de arriba de la caja de texto, verás unos botones que te permitirán colorear de manera automática bloques de código de acuerdo a tu lenguaje.

Muestra que tienes interés y tómate el tiempo de estilizar tu mensaje para una fácil lectura.

Recuerda: cuanto más sencillo sea de leer más usuarios lo leerán.

También ten en cuenta que tus mensajes los puedes reeditar (pulsando el botón de edición que hay en cada mensaje) para corregir o ampliar el mensaje original. Si vas a ampliar el mensaje, coloca un aviso al final de este con la palabra Actualización: (por ejemplo) para que los demás usuarios vean que el mensaje ha cambiado y en qué ha cambiado.

7. Selecciona un Asunto adecuado

El Asunto es la pieza principal de tu mensaje; con él describirás de lo que trata tu mensaje. No uses frases comunes como: "Ayuda".

Describe en el Asunto lo que se encontrará dentro; por ejemplo: "Crear archivos PDF con Perl"

8. NO hagas dobles publicaciones

Con una vez que publiques tu mensaje es suficiente. Si pones tu mensaje varias veces pensando que así se te va a responder más rápido, estás en un error. Eso simplemente provoca más trabajo para nuestros moderadores y lo más seguro es que menos caso se te haga.

9. Marca los hilos como RESUELTOS

Si el hilo de discusión ha resuelto tu problema, está muy bien que lo marques como resuelto. Así, visualmente, ayudarás a aquellos usuarios que buscan un hilo con un problema parecido al tuyo y que tenga una solución completa y cerrada, que es lo que la mayoría necesitamos para resolver nuestros problemas.

10. Usa los mensajes privados

El foro tiene un sistema de mensajería privada por el que te podrás comunicar con otros usuarios. Te llegará un aviso a tu buzón de correo electrónico cuando tengas mensajes privados pendientes de leer.

Si seguimos estas reglas, tendremos un foro mucho más útil y fácil de leer.

Re: Guía básica para escribir tus mensajes en el foro

NotaPublicado: 2009-07-14 19:48 @867
por explorer
A lo indicado por kidd quiero indicar una serie de ayudas y trucos para usar mejor los foros de Perl en Español.

  • Hoy en día, los navegadores pueden ayudarnos a poner una correcta ortografía. Por ejemplo, usando el Mozilla Firefox, que, por defecto, ya viene con el complemento Diccionario de Español (hay variantes para Mexicano, Argentino y Español), nos va marcando las palabras que pueden estar mal escritas en un mensaje y, con un simple clic con el botón derecho del ratón, nos mostrará sugerencias de la palabra correcta.
    .
  • Si, en el trabajo diario de edición de mensajes, hay alguna frase o contenido que repetimos mucho, podemos usar el complemento Text Complete que sirve para crear macros de teclado según el texto escrito.
    .
  • Intenta también no abusar de las palabras inglesas, aunque sean comúnmente aceptadas en informática. Si existe una palabra en español equivalente siempre es mejor que la inglesa. Hay que hacer patria lingüística ;) En Firefox existe el complemento gTranslate que, también con un golpe de ratón, nos traducirá la palabra o frase que tengamos seleccionada en pantalla.
    .
  • Las áreas de texto grande están preparadas para ser usadas con las fuentes de letras Terminus (UNIX/Linux) (Windows y Mac OSX), Mónaco y Lucida Console, por lo que es una ventaja tenerlas instaladas a la hora de editar código, por ser fuentes monoespaciadas. De todas formas, ya sabéis que podéis personalizar todo el aspecto con la ayuda del complemento Greasemonkey, como se comenta en otro hilo.
    .
  • Marcado de código
    Como este es un foro dedicado a programación, esta es una de las partes más importantes que hay que aprender.

    • Marcado simple. Marca [code]. Botón Code
      Para texto normal o código genérico o cualquier cosa que queramos que salga con letra monoespaciada.

      Con

      [code]#
      # Archivo de texto
      dato1 dato2 dato 3[/code]


      sale:

      Código: Seleccionar todo
      #
      # Archivo de texto
      dato1 dato2 dato 3



    • Marcado especial. Marca [syntax].
      Con la marca syntax podremos marcar código indicando a qué lenguaje corresponde, con lo que saldrá coloreado según las reglas de sintaxis propias de ese lenguaje.

      Ejemplo:

      [syntax]# MASM6502
      * = $8000
      lda #2
      rts[/syntax]


      sale:

      Sintáxis: [ Descargar ] [ Ocultar ]
      1. # MASM6502 
      2. * = $8000 
      3.   lda  #2 
      4.   rts 



      Atributos extra:
      • lines="geshi-n | n | geshi-f | f" - presentación y formato de los números de línea
      • start="x" - número de línea en que comienzan a numerarse las líneas
      • filename="nombre del archivo cuando se descarga"
      • highlight= - números de línea a destacar, separadas por ',' o por '-' si son consecutivas

      También se puede usar [ highlight ] ... [ /highlight ] para destacar parte de una línea.


      Ejemplo: con [syntax lines="n" filename="default.conf" highlight="2,4"], sale:

      Sintáxis: (default.conf) [ Descargar ] [ Ocultar ]
      1.     <Directory /home/usuario/public_html> 
      2.         AllowOverride All 
      3.         Order allow,deny 
      4.         Allow from all 
      5.         php_admin_value open_basedir /home/usuario/:/usr/lib/php5/:/tmp/ 
      6.     </Directory> 

      (En la línea 5 se ha usado highlight para destacar los dos primeros términos).


      También podemos indicar a qué lenguaje corresponde el código enmarcado, con la ayuda del atributo lang= o sustituyendo syntax lang="..." por el nombre del lenguaje a usar. Ejemplo: [perl]. En ese caso, los atributos que podemos usar son los siguientes:
      • lang=" php | sql | css | mysql | html4strict " - indica el lenguaje a usar. Hay más de 200 lenguajes
      • lines="geshi-n | n | geshi-f | f" - presentación y formato de los números de línea
      • start="x" - número de línea en que comienzan a numerarse las líneas
      • filename="nombre del archivo cuando se descarga"
      • fancy="5" - especifica que cada 5 líneas, el número de línea debe tener otro estilo. Solo si el estilo de las líneas es 'geshi-f' o 'f'
      Ejemplo: con [perl lines="f" fancy="10"] sale
      Sintáxis: [ Descargar ] [ Ocultar ]
      Using perl Syntax Highlighting
      1. #!/usr/bin/env perl
      2.  
      3. # usage: $0 <the_url>
      4.  
      5. use 5.16.0;
      6.  
      7. use Web::Query;
      8. use LWP::Simple;
      9. use Path::Tiny;
      10. use List::AllUtils qw/ reduce /;
      11. use CAM::PDF;
      12.  
      13. ( reduce { $a->appendPDF($b); $a } @{
      14.     wq( $ARGV[0] )
      15.     ->find('a')
      16.     ->filter( sub {
      17.         $_[1]->attr('href') =~ /\.pdf$/;
      18.     })
      19.     ->map( sub {
      20.         my $temp = Path::Tiny->tempfile;
      21.         $temp->spew( get( $_[1]->attr('href') ) );
      22.         CAM::PDF->new($temp);
      23.     })
      24. }) ->cleanoutput('aggregate.pdf');
      Coloreado en 0.003 segundos, usando GeSHi 1.0.8.4
  • Reglas del castellano que se olvidan (pero siguen vigentes):
    • Las frases interrogativas empiezan con '¿'
    • Las frases admirativas empiezan con '¡'
    • No es recomendable poner más de 3 signos '?', '¿', '¡' o '!' seguidos
    • Hay que tildar correctamente las palabras más comunes: así, ahí, aplicación, atrás, bajé, carácter, código, combinación, copié, debería, decía, después, día, dirección, expresión, fácil, función, gráfica, había, idéntica, información, instalé, instrucción, librería, línea, máquina, más, mínimo, máximo, módulo, número, numérico, ningún, opción, parámetro, pediré, podéis, publiqué, sí, solución, razón, resolución, sería, sesión, tenéis, tenía, título, último, veré, vínculo, versión
    • Esto es un foro, no un intercambio de mensajes SMS. Así que no se permite el uso de 'd' cuando se quiere escribir 'de'. Ni tampoco, 'k', 'q' y demás abreviaturas. Lo mismo con escribir con 'k'. Queda muy guay, pero no es correcto
    • Algunas palabras inglesas sí que tienen su correspondiente versión en español: link => enlace, vínculo o liga; post => mensaje, envío
    • Algunas palabras en español han sido traducidas casi literalmente del inglés, cuando existe una opción mejor: librería => biblioteca; fichero => archivo
    • Otros errores:
      • 'osea' significa 'de hueso'. Lo correcto es 'o sea'
      • 'PERL' no existe. Es 'Perl' (el lenguaje), o 'perl' (el programa intérprete del lenguaje Perl)