# Guía de estilo de la documentación

En la mayoría de los casos, Mojaloop sigue la última edición del Associated Press Stylebook. Las siguientes son directrices específicas de la fundación que han sido actualizadas y ligeramente modificadas.

# Siglas

Escriba todas las siglas de forma desarrollada en la primera mención. Incluya la sigla entre paréntesis inmediatamente después de la forma desarrollada solo si va a volver a mencionarla en el documento. Ejemplo: Kofi Annan, presidente del consejo de la Alliance for a Green Revolution in Africa (AGRA), viajó a Nairobi este mes. Era su primera visita a la oficina de AGRA.

# Ampersand

Utilice un ampersand (&) únicamente cuando forme parte de un nombre oficial, como Bill & Melinda Gates Foundation. En todos los demás casos, escriba and de forma desarrollada.

# Bill & Melinda Gates Foundation

Nuestro nombre legal oficial es Bill & Melinda Gates Foundation. Utilícelo en la primera mención. Use siempre el ampersand (&) y escriba siempre Foundation con mayúscula cuando Bill & Melinda Gates la preceda.

Nunca abrevie el nombre de la fundación como BMGF.

Nunca traduzca el nombre de la fundación a otros idiomas, ya que es un nombre propio. La única excepción es la traducción del nombre de la fundación al chino, en cuyo caso la traducción es aceptable.

No escriba foundation con mayúscula cuando la palabra aparezca sola. Ejemplo: La nueva sede de la fundación se construirá cerca del Seattle Center.

Utilice Gates Foundation solo si está seguro de que el contexto deja clara la identidad de la fundación. Existe una Gates Family Foundation en Colorado, así que hay que tener cuidado. Ejemplo: La Bill & Melinda Gates Foundation y la Ford Foundation copatrocinaron el evento. Un miembro del personal de la Gates Foundation pronunció las palabras de clausura.

La entidad que administra la dotación se conoce oficial y legalmente como Bill & Melinda Gates Foundation Trust. No necesitará referirse a esta entidad con frecuencia, pero cuando lo haga, escriba el nombre completo en la primera mención y refiérase a ella como el asset trust en adelante.

# Negrita y dos puntos

Con frecuencia veo estructuras (¡como en este mismo comentario!) en las que hay términos o frases introductorios en negrita y separados del contenido por dos puntos. ¿Deben los dos puntos ir también en negrita o no? (Con frecuencia lo veo hecho de las dos maneras.)

# Buffett

Observe la ortografía: dos efes y dos tes (es decir, Warren Buffett).

# Listas con viñetas

Introduzca las listas con viñetas con dos puntos cuando los elementos enumerados completen la frase o el fragmento introductorio. Excepción: nunca utilice dos puntos en títulos o subtítulos para introducir listas con viñetas.

Escriba con mayúscula inicial y utilice punto final en los elementos enumerados solo si son oraciones completas. Ejemplos:

Esta es una oración completa.
no es una oración completa

Nunca enlace los elementos de una lista con viñetas mediante conjunciones coordinantes y signos de puntuación (punto y coma o comas) como haría en una lista redactada dentro de una oración. Es decir, nunca haga esto:

esto,
aquello, o
lo otro.

# Pies de foto

Ponga pie a las fotos siempre que sea posible. Ayuda a que la gente entienda nuestro trabajo.

Redacte los pies de foto como frases con un único gerundio (ing verb), seguidas de la ciudad, el estado o el país y el año en que se tomó la foto, entre paréntesis. Ejemplo: Un médico preparando una vacuna para su entrega (Brazzaville, Congo, 2007)._

Al redactar un pie de foto, asegúrese de presentar a las personas que aparecen y de explicar qué ocurre en la imagen en relación con nuestras áreas de interés. Sea lo más breve posible para no distraer de la imagen ni de la maquetación. Evite los verbos que describen lo obvio sobre lo que hace el sujeto de la foto (por ejemplo, sonriendo, de pie, etc.).

Si uno de los copresidentes aparece en una foto con otras personas, asegúrese de identificarlo en el pie de foto. No dé por sentado que todo el mundo sabe cómo son nuestros copresidentes.

# Citas bibliográficas

La mayoría de los campos tienen sus propias convenciones de citación. Adopte las que se utilicen en el campo en cuestión. Cuando las convenciones de citación no estén disponibles o resulten inciertas, siga The Chicago Manual of Style.

Cuando un documento utilice tanto notas al pie como notas finales, para las notas al pie use los siguientes símbolos:

1.ª nota = * (asterisco)
2.ª nota = † (cruz)
3.ª nota = ‡ (doble cruz)
4.ª nota = § (signo de sección)
5.ª nota = ** (2 asteriscos)
6.ª nota = †† (2 cruces)
7.ª nota = ‡‡ (2 dobles cruces)
8.ª nota = §§ (2 signos de sección)

Separe las múltiples referencias en superíndice (notas al pie, notas finales) con comas, no con punto y coma.

# Ensayos clínicos

Utilice números romanos al referirse a las fases de un ensayo clínico y escriba siempre Fase con mayúscula. Ejemplo: La empresa iniciará los ensayos de Fase III del nuevo fármaco esta primavera.

# Información de contacto

Utilice puntos para separar las partes de los números de teléfono y empiece cada número con un signo más.

Dado que trabajamos con personas de todo el mundo, omita el código de acceso internacional, que varía de un país a otro (es 011 en los Estados Unidos). Ejemplos: +1.206.709.3100 (Estados Unidos) +91.11.4100.3100 (India)

# Aviso de derechos de autor y marca registrada

Todas las publicaciones, medios y materiales producidos por la fundación o para ella deberían incluir el aviso que se muestra a continuación. El equipo Legal debe aprobar todas las excepciones.

Cuando sea posible, comience la parte del aviso relativa a la marca registrada en una línea aparte.

# Rayas

Utilice la raya—del ancho de una M mayúscula—para indicar incisos o cambios bruscos de idea. Utilice la semirraya—del ancho de una N mayúscula—con los intervalos numéricos.

No incluya espacio antes ni después de la raya.

Ejemplos: Trabajamos para que los servicios financieros seguros y asequibles—en particular las cuentas de ahorro—estén más ampliamente disponibles para las personas de los países en desarrollo.

En las elecciones presidenciales de 2004, votó el 76 por ciento de los titulados universitarios estadounidenses de 25-44 años.

# Dólares ($)

En los materiales de Global Health y Global Development, dado que más de una docena de países utilizan dólares, especifique dólares estadounidenses entre paréntesis en la primera mención de un documento. Ejemplo: $100,000 (U.S.). Omita el paréntesis con U.S. en las referencias posteriores a montos en dólares dentro del mismo documento.

# Nombres de los programas de la fundación

Tenemos tres programas: Global Development Program, Global Health Program y United States Program.

Program se escribe con mayúscula cuando se usa con el nombre completo (Global Development Program), pero no cuando se usa solo (El programa concede subvenciones en varias áreas.).

Utilice puntos al abreviar el nombre del United States Program: U.S. Program.

GH, GD y USP son aceptables para uso interno, pero no son apropiados para publicaciones externas.

# La familia Gates

A William Gates III se le denomina formalmente Bill Gates. En los documentos internos, utilice Bill—no un apodo ni una abreviatura.

Utilice Melinda Gates cuando se refiera formalmente a Melinda.

Utilice William H. Gates Sr. cuando se refiera formalmente a Bill Gates Sr. No hay coma entre Gates y Sr. Bill Sr. es aceptable en los documentos internos.

Plural: Gateses. No utilice apóstrofo para formar el plural del apellido de la familia. Ejemplo: Los Gateses asistieron a la inauguración del nuevo edificio de la facultad de derecho de la University of Washington.

Posesivo: el apóstrofo va después de Gates cuando se refiere a algo que pertenece a Bill o a Melinda. Ejemplo: Melinda Gates' speech was well received. El apóstrofo va después de Gateses cuando se refiere a algo que pertenece a Bill y Melinda conjuntamente. Ejemplo: The Gateses' decision to provide free Internet access in U.S. public libraries has increased library usage and circulation overall.

También puede formularlo así: Bill and Melinda Gates' decision to provide free Internet access …

Consulte la entrada Cargos de personas para conocer los cargos formales de Bill, Melinda, Bill Sr. y otros dirigentes de la fundación.

# Guiones

Hay pocas reglas fijas en lo que respecta a los guiones. Por lo general los usamos para facilitar la comprensión del lector.

Ejemplos: When writing for the Bill & Melinda Gates Foundation, use real-world poverty examples to illustrate your point. When writing for the Bill & Melinda Gates Foundation, use real world-poverty examples to illustrate your point.

En el primer ejemplo, el guion de real-world une real y world para formar un único adjetivo que describe poverty. En el segundo ejemplo, el guion de world-poverty une world y poverty para formar un único adjetivo que describe examples.

El significado cambia según la colocación del guion. En los casos en que una serie de adjetivos genera ambigüedad sobre a qué se refieren, utilice un guion para aclarar el sentido pretendido.

Al escribir palabras con guion en mayúscula, ponga en mayúscula solo la primera parte. Ejemplo: Co-chairs Bill and Melinda Gates.

Para otros usos de los guiones—modificadores compuestos, prefijos y sufijos, fracciones—consulte el Associated Press Stylebook.

# Números

Al referirse a cifras en dólares, escriba million y billion con palabras. Utilice cifras y decimales (no fracciones). No vaya más allá de dos decimales. Ejemplo: The foundation granted 0.45 million to United Way.

Cuando utilice números que no tengan nada que ver con cifras en dólares o porcentajes, escríbalos con palabras si son menores de 10 y utilice cifras si son 10 o más. Ejemplo: Four program officers went on 13 site visits.

En los casos de paralelismo gramatical, la construcción paralela siempre prevalece sobre esta regla. Por ejemplo: Mr. Johnson has two children, 5-year-old Kyle and 13-year-old Frances.

Nunca empiece una oración con una cifra. Escriba el número con palabras o reformule la oración para que no comience con un número.

# Porcentajes

Al utilizar porcentajes, escriba percent con palabras (no use %). Utilice cifras en lugar de escribir los números con palabras, incluso si son menores de 10.

Ejemplo: This program accounts for 6 percent of our grantmaking.

# Créditos fotográficos

Si la fundación es propietaria de la imagen que utiliza, no necesita acreditar al fotógrafo. Todas las imágenes de nuestro sistema de gestión de recursos multimedia son propiedad de la fundación. Si la fundación ha adquirido una licencia para usar la imagen, es posible que deba acreditar al fotógrafo. Si tiene dudas sobre los requisitos de crédito fotográfico, póngase en contacto con el Foundation Communications Service Desk.

# Lenguaje claro

Podríamos señalar algunas construcciones concretas que resultan innecesariamente extensas. Una que detectamos con frecuencia en Ripple es "in order to" en lugar de simplemente "to".

# Comillas

Utilice comillas dobles para los diálogos y para la cita de fuentes impresas. Limite el uso de las comillas de distanciamiento—las comillas destinadas a llamar la atención sobre una palabra o frase citada y a distanciar al autor de su significado, normalmente porque el lenguaje es especializado, idiomático, irónico o incorrecto. Ejemplo: La fundación ha recurrido cada vez más a las “program-related investments” en los últimos años.

# Cadenas entrecomilladas y puntuación

Al describir cadenas exactas en documentación técnica, ¿debe incluirse la puntuación (que no forma parte de las cadenas literales) dentro de las comillas? Por ejemplo, los estados válidos son "pending," "in progress," y "completed."

# Nombres científicos

Escriba los nombres científicos con mayúscula y en cursiva, de acuerdo con las convenciones de la comunidad científica. Utilice la versión completa de un nombre científico en la primera mención y la forma abreviada en adelante. Por ejemplo, use Salmonella typhi la primera vez y S. typhi en cada referencia adicional.

# Coma serial

En las listas de tres o más elementos dentro de una oración, agregue una coma final antes de la conjunción coordinante and u or. Ejemplo: The foundation's three program areas are Global Development, Global Health, and the United States.

# Espaciado después de la puntuación

Utilice un solo espacio después de la puntuación, incluidos los puntos, los dos puntos y el punto y coma.

# Convenciones de ortografía y uso de mayúsculas

bed net: dos palabras, sin guion.

email: una sola palabra, sin guion, en minúsculas.

foundation: en minúsculas, salvo como parte del nombre completo de la fundación.

grantmaking: una sola palabra, sin guion.

nongovernmental: una sola palabra, sin guion.

nonprofit: una sola palabra, sin guion.

postsecondary: una sola palabra, sin guion.

Washington state: state en minúsculas (salvo que se refiera a Washington State University, la Washington State Legislature o algo similar).

website: una sola palabra, en minúsculas

# Cargos de personas

Los cargos formales no deberían escribirse con mayúscula salvo que el cargo preceda al nombre de una persona o aparezca en un titular. Ejemplo: La copresidenta Melinda Gates hablará este año en el Washington Economic Club.

Escriba los cargos en minúscula y de forma desarrollada cuando no se usen junto al nombre de una persona. Ejemplo: El copresidente de la fundación emitió una declaración.

Escriba los cargos en minúscula y de forma desarrollada en las construcciones que los separan del nombre mediante comas. Ejemplo: Bill Gates, copresidente de la fundación, comentó la subvención.

# Estados Unidos

Escriba United States de forma desarrollada cuando se use como sustantivo. Abrévielo como U.S. (con puntos) cuando se use como adjetivo. En determinados casos, como al referirse a una persona de los Estados Unidos, es aceptable usar American.

Ejemplos: The U.S. State Department is in the United States. The foundation's U.S. Program…

# URL

Haga referencia a las direcciones web sin el http:// de la siguiente manera: www.gatesfoundation.org

← Documentación de la API Notas del CCB →