Dudas, sobre la manera adecuada de proceder
| From: | Leonel Duran | Date: | Mon, 29 Mar 2010 23:34:02 +0000 |
| Subject: | Dudas, sobre la manera adecuada de proceder | ||
| Groups: | php.doc.es | ||
| Request: | Send a blank email to doc-es+get-2257@lists.php.net to get a copy of this message | ||
Hola a todos:
Al traducir los ficheros encontramos algunos typos, y sé que el howto
de documentación en la seccion de traductores indica que el mismo
traductor puede corregirlos en el arbol de inglés, pero como apenas
inicio en esto, no sé si fuera mejor idea que yo se los señalara a
yago para que el hiciese la corrección, o ¿no hay ningún problema si
lo hago directamente? O quizás comentarlos aquí y si cuento con
aprobación, entonces si corregirlos yo mismo.
Adicionalmente tengo un par de dudas sobre convenciones o preferencias
de algunos casos que me encontré al traducir apendices/oop4.xml, como
aún no conozco la manera ideal de enfrentarlos, quisiera preguntarles
cuál opción es la mejor o la preferida dentro del proyecto. Y si lo
consideran conveniente, agregar su resolución a algún fichero como
diccionario.txt que se encuentra en el repositorio de googlecode y que
creo sería muy útil para agilizar las dudas y ayudar a la
consistencia. Al menos a mi me sacó de muchos aprietos, pero estos
casos que menciono a continuación no se encontraban ahí. (No se si
yago pudiera agregarlos una vez resueltos).
https://phpdoc-es.googlecode.com/svn/trunk/diccionario.txt
Mis dudas surgen a raíz del archivo apendices/oop4.xml, así que lo uso
como referencia para ilustrar.
Cerca de la línea 311, se menciona que se puede consultar algún otro
tema en los directorios "Class/Object", en la traducción preliminar lo
he dejado tal cual, dado que en el arbol de español así aparecen, pero
no sé si lo correcto sea dejar el nombre del directorio de la
documentación en su original o si al final esos directorios verían
traducidos sus nombres en el futuro.
La otra duda es "include file" en el contexto de la línea 666 @_@, no
sé cuál sería el término que se prefiere. ¨fichero de include",
¨fichero de includes", "fichero de inclusión", etc. Por ejemplo en
documentaciones de proyectos de lenguaje C se utiliza "ficheros de
cabecera", pero eso es porque en C se utilizan específicamente para
incluír cabeceras primordialmente, sé que no es ese el caso en php,
así que les agradecería si pudieran ayudarme a entender cual sería el
mejor criterio.
Yago, muchas gracias, ya pude hacer commit del archivo translation.xml
exitosamente. :D
De antemano, gracias a todos por su ayuda. :p
_______________
Leonel