---
authors:
  - 
    author: 'The FreeBSD Documentation Project'
copyright: '2023 The FreeBSD Documentation Project'
description: 'Instrucciones tanto para autores como editores de los informes de estado'
title: 'Proceso de Informe de Estado de FreeBSD'
trademarks: ["freebsd", "git", "github", "general"]
---

= Proceso de Informe de Estado de FreeBSD
:doctype: article
:toc: macro
:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
:source-highlighter: rouge
:experimental:

'''

toc::[]

Los informes de estado de FreeBSD se publican trimestralmente y proporcionan al público general una visión de lo que está sucediendo en el Proyecto, y normalmente se amplían con informes especiales de las Cumbres de Desarrolladores. Como son una de nuestras formas de comunicación más visibles, son muy importantes.

A lo largo de este documento y en otros lugares relacionados con los informes de estado de FreeBSD también, la expresión _informe de estado_ se usa tanto para indicar el documento publicado de forma trimestral como las entradas individuales que hay en él.

== Instrucciones para los autores

Esta sección proporciona algún consejo para escribir entradas de informes de estado de parte de mailto:theraven@FreeBSD.org[David Chisnall], quien tiene mucha experiencia en escritura técnica. También se dan instrucciones sobre cómo enviar tus entradas.

_No te preocupes si no eres anglo parlante. El mailto:status@FreeBSD.org[status team] comprobará tus entradas desde el punto de vista de la ortografía y la gramática, y lo arreglará por ti._

=== Presenta Tu Trabajo

_No asumas que la persona que lee el informe sabe acerca de tu proyecto._

Los informes de estado se distribuyen ampliamente. Están habitualmente en lo alto de la lista de noticias en el sitio web de FreeBSD y son una de las primeras cosas que la gente leerá si quieren conocer lo que es FreeBSD. Considera este ejemplo:

....
Se ha añadido soporte para abc(4), incluyendo compatibilidad con frobnicator.
....

Alguien que lea esto, si está familiarizado con las páginas de manual de UNIX, sabrá que `acb(4)` es algún tipo de dispositivo. ¿Pero por qué le debería importar al lector?¿Qué tipo de dispositivo es? Compara con esta versión:

....
Se ha añadido un driver nuevo, abc(4), al árbol de fuentes que proporciona soporte
para el rango Frobnicator de interfaces de red de Yoyodyne.
....

Ahora el lector sabe que abc es un controlador de un interfaz de red. Incluso si no usa ninguno de los productos de Yoyodyne, has comunicado que el soporte en FreeBSD para los dispositivos de red está mejorando.

=== Muestra la Importancia de Tu Trabajo

_Los informes de estado no son sólo para decirle a todo el mundo que se están haciendo cosas, también necesitan explicar por qué se están haciendo._

Continuemos con el ejemplo anterior. ¿Por qué es interesante que ahora soportemos las tarjetas Frobnicator de Yoyodyne? ¿Son habituales? ¿Se usan en algún dispositivo popular? ¿Se usan en un nicho de mercado particular donde FreeBSD tiene (o le gustaría tener) presencia? ¿Son las tarjetas más rápidas del planeta? Los informes de error habitualmente incluyen cosas como estas:

....
Importamos Cyberdyne Systems T800 en el árbol.
....

Y luego paran. A lo mejor el lector es un ávido fan de Cyberdyne y conoce todas las características excitantes del nuevo T800. Es improbable. Es mucho más probable que haya oído hablar vagamente de lo que quiera que hayas importado (especialmente en el árbol de ports: recuerda que hay cerca de 30,000 cosas ahí también...). Proporciona una lista de nuevas características, o fallos corregidos. Diles por qué es bueno que tengamos una nueva versión.

=== Dinos Algo Nuevo

_No recicles los mismos elementos del informe de estado._

Ten en cuenta que los informes de estado no son sólo informes de estado del proyecto, son informes sobre el cambio de estado del proyecto. Si hay un proyecto en curso, utiliza un par de frases para presentarlo, pero utiliza el resto del informe hablando acerca del trabajo nuevo ¿Qué progresos se han hecho desde el último informe? ¿Qué queda por hacer? ¿Cuándo es probable que termine (o, si "terminado" no se puede aplicar, cuando está previsto que esté listo para un uso más amplio, para pruebas, para desplegarlo en producción, etc)?

=== Patrocinio

_No te olvides de tus patrocinadores._

Si tú o tu proyecto habéis recibido patrocinio, una beca de alguien o habéis trabajado como consultor externo o empleado para una empresa, por favor inclúyelo. Los patrocinadores siempre aprecian que les agradezcas su inversión, pero también es beneficioso para ellos mostrar que están activos apoyando el Proyecto de esta forma. Por último, pero no por ello menos importante, esto ayuda a FreeBSD a aprender más acerca de sus consumidores importantes.

=== Elementos Abiertos

_Si se necesita ayuda, ¡hazlo explícito!_

¿Se necesita ayuda con algo? ¿Hay tareas que pueda hacer otra gente? Hay dos formas en la que puedes usar la parte de elementos abiertos del informe de estado: para solicitar ayuda, o para ofrecer un resumen rápido de la cantidad de trabajo pendiente. Si ya hay suficiente gente trabajando en el proyecto, o si está en un estado en el que añadir más gente no va a hacer que vaya más rápido, entonces esta segunda opción es mejor. Da algunos elementos grandes que están en progreso, y quizás indica quién se está enfocando en cada uno.

Lista tareas, con suficiente detalle como para que la gente sepa si son capaces de hacerlas, e invita a que la gente entre en contacto.

=== Envía tu informe

Los siguientes métodos están disponibles para enviar tus informes:

* envía una link:https://reviews.freebsd.org/[revisión en Phabricator] y añade al grupo _status_ a la lista de revisores. Deberías poner tus informes en el subdirectorio apropiado de `doc/website/content/en/status/` (créalo si no existe);

* envía una pull request al repositorio doc mediante link:https://github.com/freebsd/freebsd-doc[su réplica en GitHub]. Deberías poner tus informes en el subdirectorio apropiado de `doc/website/content/en/status` (créalo si no existe);

* envía un email a status-submissions@FreeBSD.org adjuntando tu informe.

Está disponible link:https://www.FreeBSD.org/status/report-sample.adoc[una plantilla de ejemplo en formato Asciidoc].

== Instrucciones para los editores

Esta sección describe cómo funcionan los procesos de revisión y publicación.

[.informaltable]
[cols="1,1", frame="none"]
|===

|Página web principal de los informes de estado
|link:https://www.FreeBSD.org/status/[https://www.FreeBSD.org/status/]

|Informes de estado archivados en el repositorio de GitHub (se usó para los informes desde 2017Q4 hasta 2022Q4):
|link:https://www.github.com/freebsd/freebsd-quarterly[https://github.com/freebsd/freebsd-quarterly]

|Direcciones de email principales del equipo _status_
|link:mailto:status@FreeBSD.org[status@FreeBSD.org]

|Dirección de email para el envío de informes
|link:mailto:status-submissions@FreeBSD.org[status-submissions@FreeBSD.org]

|Lista de correo para recibir avisos de informes de estado
|link:https://lists.freebsd.org/subscription/freebsd-status-calls[freebsd-status-calls@FreeBSD.org]

|Página de Phabricator del equipo _status_
|link:https://reviews.freebsd.org/project/profile/88/[https://reviews.freebsd.org/project/88/]
|===

=== Planificación

Los informes siempre son aceptado por el _status team_, pero el proceso de recolección principal sucede en el último mes de cada trimestre, esto es en Marzo, Junio, Septiembre y Diciembre. Se enviarán llamadas para los informes de estado en esos meses. Los meses de Enero, Abril, Julio y Octubre se dedican a organizar los informes enviados durante el trimestre anterior; esto puede incluir esperar por envíos tardíos. La publicación de los informes de estado se realiza durante los mismos meses en cuanto el informe está listo.

Todos los envíos de informes pueden extender su fecha límite link:mailto:status-submissions@FreeBSD.org[enviando un email al _status team_] hasta la fecha extendida, que es 8 días después del final del trimestre. Las entradas del link:https://www.freebsd.org/administration/#t-portmgr[equipo de gestión de ports] tienen por defecto la fecha de entrega extendida, porque los informes de estado se solapan con las ramas trimestrales de los ports.

La revisión de los informes enviados por parte de gente que no es parte del _status team_ debería estar completada a mediados de Enero/Abril/Julio/Octubre (congelación de la revisión de terceros). Es decir, con excepción de faltas ortográficas u otro tipo de edición sencilla, el _status team_ debería empezar a ensamblar los envíos poco después del día 15. Fíjate en que no es un congelación completa, y el _status team_ todavía podría aceptar revisiones por entonces.

[cols="1,2,2,2,2"]
|===
||Primer trimestre|Segundo trimestre|Tercer trimestre|Cuarto trimestre

|Primera llamada para informes
|1 de Marzo
|1 de Junio
|1 de Septiembre
|1 de Diciembre

|Recordatorio de 2 últimas semanas
|15 de Marzo
|15 de Junio
|15 de Septiembre
|15 de Diciembre

|Último recordatorio
|24 de Marzo
|24 de Junio
|24 de Septiembre
|24 de Diciembre

|Fecha límite estándar
|31 de Marzo
|30 de Junio
|30 de Septiembre
|31 de Diciembre

|Fecha límite extendida
|8 de Abril
|8 de Julio
|8 de Octubre
|8 de Enero

|Semicongelación de revisión de terceros
|15 de Abril
|15 de Julio
|15 de Octubre
|15 de Enero
|===

=== Llamadas para informes

Las llamadas para los informes de estado se envían a los siguientes destinatarios:

* la link:https://lists.freebsd.org/subscription/freebsd-status-calls[lista de correo freebsd-status-calls@FreeBSD.org];
* a todos los que enviaron los últimos informes de estado (podrían tener actualizaciones u otras mejoras);
* y, dependiendo de la temporada:
	** Organizadores de varias conferencias:
		*** link:mailto:secretary@asiabsdcon.org[AsiaBSDCon] en Marzo (Primer Trimestre);
		*** link:mailto:info@bsdcan.org[BSDCan] en Mayo (Segundo Trimestre);
		*** EuroBSDcon Septiembre - Octubre (Tercer-Cuarto Trimestre).
		EuroBSDcon como organización no está interesada en escribir informes de estado para FreeBSD (al menos no lo estaba en 2019: la razón es que no es una conferencia específica de FreeBSD), así que los informes acerca de este evento se deben pedir a los miembros de la comunidad de FreeBSD que asistieron al mismo;
	** link:mailto:soc-students@FreeBSD.org[Estudiantes] del Google Summer of Code y sus link:mailto:soc-mentors@FreeBSD.org[mentores].

La forma más fácil de enviar las llamadas para los informes de estado es usar el link:https://cgit.freebsd.org/doc/tree/tools/sendcalls/sendcalls[script perl [.filename]#sendcalls#] en el directorio [.filename]#tools/sendcalls# del repositorio doc en git . El script automáticamente envía llamadas a todos los destinatarios. También puede ser usado desde un trabajo cron, por ejemplo:

....
0      0       1,15,24 3,6,9,12        *       cd ~/doc/tools/sendcalls && git pull && ./sendcalls -s 'Lorenzo Salvadore'
....

[IMPORTANT]
====
Si estás a cargo de enviar las llamadas para los informes de estado y estás usando un trabajo cron, por favor ejecútalo en freefall y fírmalo con tu nombre de forma que sea posible inferir quién ha configurado el trabajo, en caso de que algo vaya mal. Por favor actualiza también el ejemplo anterior con tu nombre, como una medida de seguridad adicional.
====

También podría merecer la pena hacer una llamada para los informes en los foros como link:https://forums.freebsd.org/threads/call-for-freebsd-2014q4-october-december-status-reports.49812/[se hizo en el pasado].

=== Construyendo el informe

Los informes enviados son revisados e integrados en el subdirectorio apropiado de [.filename]#doc/website/content/en/status/# conforme van llegado. Mientras los informes están siendo actualizados, gente fuera del _status team_ también puede revisar las entradas individuales y proponer arreglos.

Normalmente el último paso en el proceso de revisión del contenido es escribir la introducción en un fichero llamado [.filename]#intro.adoc#: una buena introducción sólo puede escribirse una vez que se han recolectado todos los informes. Si es posible, es una buena idea pedir a distintas personas que escriban la introducción para añadir variedad: personas distintas ofrecerán distintos puntos de vista y ayudarán a mantenerlo fresco.

Una vez que los informes y la introducción están listos, se necesita crear el fichero [.filename]#_index.adoc#: este es el fichero en el que los informes son distribuidos en categorías y ordenados.

=== Publicando el informe

Cuando todos los ficheros del informe de estado están listos, es momento de publicarlo.

Primero se edita [.filename]#doc/website/content/en/status/_index.adoc#: se actualiza la siguiente fecha de entra y se añade un enlace al nuevo informe. Después se empuja el cambio al repositorio y el _status team_ comprueba que todo funciona como se espera.

Después se añade la entrada a la sección de noticias de la página web principal en [.filename]#doc/website/data/en/news/news.toml#.

Aquí hay una muestra de la entrada de noticias:
....
[[news]]
date = "2021-01-16"
title = "October-December 2020 Status Report"
description = "The <a href=\"https://www.FreeBSD.org/status/report-2020-10-2020-12.html\">October to December 2020 Status Report</a> is now available with 42 entries."
....

Una vez que la versión HTML del informe se ha construido y está online, se usa man:w3m[1] para volcar la página web como texto plano, e.g:
....
% w3m -cols 80 -dump https://www.FreeBSD.org/status/report-2021-01-2021-03/ > /tmp/report-2021-01-2021-03.txt
....

man:w3m[1] tiene soporte completo para unicod. `-dump` simplemente extrae texto renderizado del código HTML en el que se pueden omitir algunos elementos, mientras que `-cols` asegura que todo está dentro del límite de 80 columnas.

Se añade un enlace al informe renderizado entre la introducción y la primera entrada.

Finalmente el informe está listo para ser enviado, cambiando la disposición (el informe debe ser _inline_), y asegurándose de que esté codificado en UTF-8.

Se envían dos correos, ambos con un tema con formato `FreeBSD Status Report - <First/Second/Third/Fourth> Quarter <year>`:

* uno a link:https://lists.freebsd.org/subscription/freebsd-announce[freebsd-announce@FreeBSD.org];

[IMPORTANT]
====
Este debe ser aprobado, así que si estás a cargo de enviar este email, asegúrate de que alguien lo hace (envía un correo a link:mailto:postmaster@FreeBSD.org[postmaster] si tarda demasiado).
====

* uno a link:https://lists.freebsd.org/subscription/freebsd-hackers[freebsd-hackers@FreeBSD.org], que también tiene link:https://lists.freebsd.org/subscription/freebsd-current[freebsd-current@FreeBSD.org] y link:https://lists.freebsd.org/subscription/freebsd-stable[freebsd-stable@FreeBSD.org] en CC y a `developers@FreeBSD.org` en BCC.
