-
Notifications
You must be signed in to change notification settings - Fork 14.6k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Spanish translation for the spanish users :)
- Loading branch information
Showing
1 changed file
with
42 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
# Guía de Estilo | ||
|
||
Del Manual de Estilo de GitHub, del cual esta guía de estilo hereda: | ||
|
||
> Las palabras son una parte importante de cómo funciona el software. Así como tenemos una guía de estilo para nuestro código, también tenemos una guía de estilo para nuestro tono y nuestra voz. Aunque pueda haber docenas de personas creando un producto, debería sonar como si hablamos con una voz coherente. | ||
> | ||
> En otras palabras, la forma en que escribimos es tan importante como la forma en que diseñamos. Considera estas cosas cuando escribas contenido. | ||
Cuando sea posible, las [pruebas automatizadas](../test/prose) imponen reglas de estilo. | ||
|
||
## Principios de Contenido | ||
Todo el contenido escrito debe seguir estos principios: | ||
|
||
* **Accesibilidad:** No asumas que el lector tiene conocimientos previos. | ||
* **Brevity:** Manténlo simple, enlaza a contenido externo para profundizar. | ||
* **Curación:** Amplifica las mejores prácticas de la comunidad frente al punto de vista de un individuo. | ||
|
||
El contenido debe mantener un tono ligero pero sabio (piensa en elegante, no en exceso emocionado). ¡El código abierto es divertido! Los lectores deben sentirse inspirados, no desanimados, por el tono de tu escritura, y deben confiar en que les ayudarás a comenzar. | ||
|
||
## Menciones | ||
|
||
Al referirse a personas que usan GitHub, utiliza @menciones de su nombre de usuario en lugar de su nombre completo. | ||
|
||
- :smile: Como dijo @jessfraz... | ||
- :cry: Como dijo [Jess Frazelle](https://github.com/jessfraz)... | ||
|
||
Al referirse a un proyecto en GitHub, enlaza al repositorio para que otros puedan profundizar si lo desean. | ||
|
||
- :smile: @maxogden tomó un enfoque similar a [Dat](https://github.com/datproject/dat)... | ||
- :cry: @maxogden tomó un enfoque similar a Dat... | ||
|
||
## Capitalización | ||
|
||
"Guías" se capitaliza cuando se refiere a las "Guías de Código Abierto", pero no cuando se dice "la guía" o "esta guía". | ||
|
||
- :smile: ¡Bienvenido a las Guías de Código Abierto! | ||
- :smile: La guía está destinada a... | ||
- :cry: El objetivo de esta Guía es... | ||
|
||
## Más orientación | ||
|
||
Entiende nuestro [modelo de contenido](content-model.md) y [audiencia](personas.md). |