Ver Mensaje Individual
  #8  
Antiguo 06-12-2008
Avatar de roman
roman roman is offline
Moderador
 
Registrado: may 2003
Ubicación: Ciudad de México
Posts: 20.269
Reputación: 10
roman Es un diamante en brutoroman Es un diamante en brutoroman Es un diamante en bruto
Como se dice por ahí, a buen árbol te arrimas. Creo que falta pulir mucho la redacción, el uso de los tiempos verbales, los pronombres y los artículos. Una muestra de cómo creo que puede mejorarse:

Original

Cita:
In short words, a Gesbit plugin is a piece of software that can be addon to a Gesbit installation to perform some task. What task? Hum, the only limit is your imagination. Gesbit offers to you the needed resources to develop plugins, and you can use this whatever you want

However, some conventions and requisites must be supplied by your plugin, and, in this tutorial we want to explain you all the needed information to write your own Gesbit plugin from scratch. But remember that a better way to learn about how a plugin working is viewing the exists Gesbit plugins.

Gesbit plugins can be use to enhanced the Gesbit themes or administration panel. Can be use for users to show anything in the theme templates, or can make some task without the user attention. A plugin can be very useful to Gesbit users, and can be simple or the complex that whatever you want.
Cambio

Cita:
In few words, a plugin is a piece of software that can be added to Gesbit to perform some additional task. What kind of task? Hum, the limit is your imagination. Gesbit offers all the necessary resources to develop plugins and you can use them in whatever way you want.

However, some conventions and requisites must be fulfilled by a plugin in order to work with Gesbit, and this tutorial explains all you need to know to write your own plugins from scratch. But remember that the best way to learn about how plugins work is by examining existing Gesbit plugins.

Gesbit plugins can be use to enhance Gesbit themes or its administration panel. It can be useful to show anything in theme templates, or to perform some task without user attention. A plugin can be very useful to Gesbit users, and can be as simple or as complex as you want.
Como ya te han comentado, uno que habla tu misma lengua, puede entender casi todo, pero para un anglo parlante o hablante de cualquier lengua distinta del español, pudiera encontrarse con partes muy obscuras.

Y es que, si ya es difícil redactar en nuestra lengua, doblemente difícil es hacerlo en otra.

Creo (y subrayo el creo), que más valdría hacer la documentación primeramente en español (que a todos nos consta, dominas bastante más que la mayoría) y posteriormente traducirla al inglés, bien sea tú mismo, o alguien que lo desee.

Ya sé, entiendo que la intención es llegar al mayor público posible, pero bueno, a fin de cuentas es software desarrollado por un hispanoparlante. ¿Qué pasará cuando sea famoso y se requiere documentación en español? ¿Alguien traducirá al español del original inglés?

Pero bueno, sólo son comentarios...

// Saludos
Responder Con Cita