Consejos para el estilo, la gramática, el contenido y el SEO (posicionamiento en buscadores)

No mezcle fuentes mono espaciales con fuentes proporcionales en una oración. Utilice cursiva para el texto especial. Por ejemplo, no escriba dnf install foo en medio de una oración, escriba dnf install foo.

Utilice cursiva para objetos del sistema que mencione en una oración:

Utilice el estilo Preformateado en el editor WordPress para la entrada o salida de línea de comando. Utilice un indicador de shell ($ o #) solo donde genuinamente afecte al significado o establezca la salida aparte de la entrada. También ayuda utilizar negrita para la entrada en si:

$ command arg1 arg2
output line 1
output line 2

Utilice negrita solo para una frase o declaración extremadamente importante.

Utilice mayúsculas y minúsculas para el título de la publicación y los títulos de los encabezados. No escriba con mayúsculas las palabras en el título de su artículo ni en ningún encabezado, excepto los nombre propios. Esto evita discusiones innecesarias sobre el caso del título, que difiere según la región.

Revise la ortografía y la gramática. A nadie le gustan los comentarios quisquillosos sobre esto. Compruebe su trabajo antes de enviárselo a un editor. Editor: ¡comprueba todo el trabajo, ese es tu trabajo!

Escriba claramente y utilice oraciones más cortas. La brevedad es buena. La claridad es mejor. No hable demasiado cuando se pueda evitar. Si una oración más larga es más fácil de leer, utilice palabras adicionales.

Evite la voz pasiva. La voz pasiva es el uso del objeto de una oración como sujeto. Por ejemplo:

Tenga cuidado con los gerundios (palabras -ndo). Normalmente indican la voz pasiva. Vuelva a escribir su oración para hacerla más fuerte. Por ejemplo:

Evite el tiempo futuro innecesario. A menos que esté hablando de planes o publicaciones futuras, el tiempo presente es mejor.

Evite el uso excesivo del verbo to be (ser) en las oraciones. Demasiado uso de es, será o puede ser hace que las oraciones sean débiles y flojas. Intente utilizar la forma verbal de palabras que ha utilizado en otras partes de la oración. A menudo puede simplemente omitir palabras o usar la forma imperativa (de orden o consejo) de la oración.

Utilice el Inglés estadounidense para la ortografía y otras diferencias internacionales. El Inglés estadounidense en la lengua franca del Proyecto Fedora en general.

Tenga un flujo fluido desde la información general hasta las instrucciones específicas. Si no está seguro de como estructurar su artículo de esta manera, consulte nuestra plantilla inicial.

Deje los archivos empaquetados en paz. Los procesos no deberían implicar la edición de archivos en carpetas del sistema como /usr o /lib*. Edite /etc o una configuración específica del usuario en el directorio home.

Prefiera software libre cuando sea práctico (y software empaquetado oficialmente siempre que sea posible). El Magazine aún puede cubrir software que no sea FOSS (Software Libre y de Código Abierto) para ser utilizado en Fedora, donde sabemos o sospechamos que el software es muy popular y útil entre los usuarios de Fedora. (Google Chrome es un buen ejemplo.) Pero si su artículo está cubriendo un proceso general, use software FOSS.

Utilice libvirt/KVM en los consejos, no VirtualBox u otros hipervisores. Con frecuencia la gente que viene de otras plataformas tiene experiencia en VirtualBox. Sin embargo, el hipervisor KVM y libvirt en Fedora son FOSS y parte de la plataforma. Utilícelos, escriba sobre ellos, ámelos.

A menos que sea necesario, utilice distribuciones de la familia Fedora. Fedora Magazine promueve Fedora. A no ser que el punto de su artículo sea explicar específicamente un mecanismo de distribución cruzada, utilice instalaciones, contenedores o distribuciones dentro de su familia (Fedora, CentOS, RHEL).

El software Copr debe ir acompañado de una advertencia. El sistema de construcción Copr no está administrado por el equipo de lanzamiento de Fedora y no proporciona construcciones oficiales de software. Si usted cubre algún software de Copr, compruebe que no haya una compilación oficial. Si no, incluya una declaración como esta: Copr is not officially supported by Fedora infrastructure. Use packages at your own risk (Copr no está soportado oficialmente por la infraestructura Fedora. Utilice los paquetes bajo su responsabilidad).

Evite el lenguaje excluyente o problemático. Estos son ejemplos de la terminología a evitar siempre que sea posible en los artículos:

Pruebe sus procesos. Si es posible, utilice una VM (Máquina Virtual) invitada nueva — o al menos una cuenta de usuario nueva. Ejecute su proceso de principio a final para comprobar que funciona. Arregle, enjuague y repita.

Utilice el estilo correcto para terceros. Los nombres de compañías, proyectos y tecnologías no siempre siguen las reglas de estilo de las típicas palabras en Inglés. Elija el estilo utilizado por los sitios web autorizados cuando no esté seguro. Si las fuentes autorizadas utilizan estilos inconsistentes, utilice su mejor juicio. Una lista no exhaustiva:

Utilice un Fedora Workstation estándar nuevo, no su escritorio o configuración personal. (Es mejor hacer una VM con una instalación nueva Fedora Workstation y haga los pasos allí.) Si muestra algo que depende de otro escritorio, haga una instalación nueva y úsela.

Establezca la resolución de pantalla a un valor razonable pero no demasiado alto, como 1280x960 o 1280x800.

Si solo muestra una ventana del navegador, hágala bastante grande en pantalla y haga una captura de pantalla solo del navegador. (Sugerencia: ¡puede usar la aplicación Screenshot para esto!)

Si solo está mostrando una aplicación, utilice el tamaño predeterminado de la aplicación para hacer la captura de pantalla.

Cargue y utilice ese medio original en su artículo. Si la captura es grande, como una gran ventana de navegador, aplicación o la pantalla completa, elija una miniatura de tamaño medio y deje que WordPress maneje la conversión.

Utilice un título sencillo y relevante. Preferiblemente esto debería ser una llamada a la acción, como Build a widget using GTK+ (Crear un widget usando GTK+) o una descripción de la lista, como 5 fun games in Fedora (5 divertidos juegos en Fedora). El título afecta a los motores de búsqueda y lleva a más sugerencias y a una clasificación más alta de la página. Esto ayuda a dirigir el tráfico hacia el Magazine.

Proporcione una imagen destacada. Vea en la información de aquí consejos sobre las imágenes destacadas. También puede pedir a los editores que le asignen esto. Si usted hace su propia imagen, intente que coincida con el estilo de las otras imágenes. Use los recursos proporcionados en la guía de imagen destacada. No agregue sus propias fuentes ni se desvíe de la guía.

Utilice buenas prácticas de SEO. Utilice el complemento SEO proporcionado para maximizar la clasificación de búsqueda del artículo. Apunte a una clasificación “verde” en el cuadro Publish (Publicar) en la parte superior derecha de la ventana de edición del artículo. Siga estas directrices:

Utilice la opción Edit as HTML (Editar como HTML) al pegar en bloques preformateados. Se sabe que las versiones actuales de WordPress eliminan las marcas de almohadilla (#) y los espacios en blanco iniciales cuando el contenido se pega en bloques preformateados. Algunos caracteres no alfanuméricos también pueden resultar confusos (&, <, >, etc.). Usar la opción Edit as HTML (que aparece debajo de los puntos suspensivos verticales) antes de pegar contenido en el bloque parece solucionar el problema. Asegure de pegar su contenido entre las etiquetas <pre> y no las sobrescriba. Después de pegar su contenido, vuelva al modo visual utilizando la opción Edit visually (Editar visualmente) para ver una mejor representación del resultado final, lo verá como el lector.