Preguntas frecuentes

Fase actual:
La temporada de Documentos 2020 finalizó el 15 de marzo de 2021. Consulta el cronograma.

General

¿Es Season of Docs un programa de reclutamiento?

No. Si te interesa trabajar para Google, visita el sitio web de empleos de Google.

¿La temporada de Documentos se considera una pasantía, un trabajo o alguna forma de empleo?

No. La temporada de Documentos es una actividad que realiza el escritor técnico como escritor técnico independiente por la que se le paga una remuneración. Los escritores técnicos pueden optar por no recibir el subsidio.

¿Por qué debería participar en Season of Docs?

El objetivo de Season of Docs es fomentar la colaboración entre las organizaciones de código abierto y los escritores técnicos. Creemos que este programa hará lo siguiente:

  • Brinda a los escritores técnicos la oportunidad de ganar experiencia en la contribución a proyectos de código abierto y aprender sobre el código.
  • Dales a los proyectos de código abierto la oportunidad de atraer a la comunidad de escritura técnica y, por lo tanto, de mejorar sus documentos de código abierto.
  • Aumenta el reconocimiento de los documentos de código abierto y de la redacción técnica.

Beneficios para las organizaciones de código abierto:

  • Experiencia con un escritor técnico.
  • Documentos mejorados.
  • El potencial de colaboración continua con escritores técnicos después de que termine la temporada de Documentos.
  • Procesos mejorados para documentar tus proyectos.
  • Se aumentó el conocimiento de los documentos de código abierto entre la comunidad de escritura técnica.

Beneficios para los escritores técnicos:

  • Experiencia en el aporte de proyectos de código abierto.
  • Experiencia con documentos centrados en el desarrollador y con código
  • Crédito y reconocimiento por el trabajo realizado.
  • Algo para agregar a tu currículum.
  • El potencial de colaboración continua con el proyecto de código abierto después de que termine la temporada de Documentos
  • Mayor reconocimiento en las comunidades de código abierto sobre el valor que pueden aportar los escritores técnicos.

¿Qué tipos de proyectos pueden abordar los escritores técnicos?

A continuación, le proponemos algunas ideas:

  • Crea un sitio de documentación en una plataforma que decidan el escritor técnico y el mentor de código abierto, y publica un conjunto inicial de documentos básicos en el sitio. Estos son algunos ejemplos de plataformas:

  • Refactoriza la documentación existente del proyecto de código abierto para proporcionar una experiencia del usuario mejorada o una arquitectura de la información más accesible.

  • Escribir una descripción general conceptual de un producto o función, o una introducción a ellos A menudo, un equipo crea su documentación técnica de abajo hacia arriba. Como resultado, hay muchos detalles, pero es difícil comprender el producto en su conjunto. Un escritor técnico puede solucionarlo.

  • Crea un instructivo para un caso de uso de alto perfil.

  • Crea un conjunto de guías prácticas enfocadas para tareas específicas.

  • Crea una guía para colaboradores que incluya información básica sobre cómo comenzar a trabajar en el proyecto de código abierto, así como las reglas relacionadas con los contratos de licencia, los procesos para las solicitudes de extracción y las revisiones, la compilación del proyecto, etcétera.

¿Es un video un proyecto posible para la temporada de Documentos?

Sí. Depende de la organización de código abierto publicar ideas de proyectos y elegir una propuesta de proyecto enviada por un escritor técnico. Si un video cumple con los requisitos de la organización de código abierto, puedes enviarlo como un proyecto de la temporada de Documentos, siempre que sea un video de instrucción técnica. Asegúrate de que los requisitos de video tengan un alcance adecuado y ten en cuenta que producir un video de alta calidad requiere tiempo y recursos.

¿Las organizaciones de mentoría deben usar los documentos producidos por escritores técnicos?

No. Si bien esperamos que toda la documentación y el código que surge de este programa encuentre un hogar feliz, no exigimos que las organizaciones usen los documentos o el código de los escritores técnicos.

¿Dónde tiene lugar la temporada de Documentos?

La temporada de Documentos ocurre completamente en línea. No es necesario viajar como parte del programa.

¿Cómo puedo mantenerme al tanto de la temporada de Documentos?

Visita la lista de distribución de anuncios en season-of-docs-announce para ver las actualizaciones y los anuncios más recientes relacionados con la temporada de Documentos. Únete al grupo para recibir actualizaciones por correo electrónico.

¿Qué puedo hacer para ayudar a correr la voz sobre la temporada de Documentos?

Puedes twittear sobre el programa, escribir entradas de blog, publicar videos, o bien organizar una reunión o una sesión informativa en tu área. Tenemos contenido y recursos de muestra que puedes usar para distribuir a tu comunidad (organización, grupo de escritores y otros contactos).

¿Cómo organizo u organizo una reunión informativa o una reunión de la temporada de Documentos de Google?

Puedes programar una reunión en cualquier momento y lugar que te resulten convenientes. Revisa las reglas del programa y usa el contenido de muestra.

¿Puedo participar en Season of Docs como mentor y escritor técnico?

No. Queremos asegurarnos de que cada proyecto y escritor técnico reciba suficiente atención, y creemos que esto podría crear una mala experiencia para los participantes. Elige si te resulta más atractivo participar como mentor o escritor técnico y piensa si te postularás según corresponda.

¿Hay estadísticas que puedas compartir sobre la temporada 2019 de Documentos?

Sí. Puedes consultar los resultados de la temporada de Documentos de 2019 para el programa de 2019 aquí.

¿Recibiré una camiseta de la temporada de Documentos de Google?

Sí. Los escritores y mentores técnicos en proyectos completados con éxito recibirán una camiseta de la temporada de Documentos.

¿Cuándo llegará mi camiseta?

Estimamos que recibirás la camiseta a principios de 2021. Google contrató a un proveedor para que produzca las camisetas y se encargue de la logística de enviarlas a todo el mundo. Los administradores del programa de Google te enviarán un código de acceso único por correo electrónico para que selecciones el estilo o la talla de tu camiseta y, luego, ingreses los detalles de envío poco después del anuncio de los resultados del proyecto de larga duración. La producción y el envío de las camisetas suele demorar algunas semanas.

¿Cómo puedo resolver otras dudas que pueda tener?

Consulta la guía para escritores técnicos, la guía para el mentor y la guía para administradores de la organización.

Si todavía no tienes una respuesta después de leer toda la documentación, considera analizar tus preguntas con la comunidad de la temporada de documentos en Slack o en la lista de discusión. Consulta la información sobre los canales de discusión y cómo comunicarte con nosotros.

Para escritores técnicos

¿Cuándo pueden postularse los escritores técnicos para la temporada de Documentos?

La fase de postulación del escritor técnico dura del 9 de junio de 2020 al 9 de julio de 2020. Consulta el cronograma del programa y la guía para escritores técnicos.

¿Qué herramientas y frameworks de documentación debo conocer para participar en la temporada de Documentos?

Las herramientas de documentación y los frameworks que usarás dependen de la organización con la que te interesa trabajar. Parte del objetivo de Season of Docs es que los proyectos de código abierto ayuden a los escritores técnicos a obtener más información sobre las herramientas y los frameworks involucrados en la documentación de productos de código abierto. Por ese motivo, no es necesario que tengas conocimientos detallados sobre plataformas de documentación específicas antes de comenzar tu proyecto de la temporada de Documentos.

Dicho esto, la mayoría de las organizaciones de código abierto usan una versión de Markdown o de otro lenguaje de marcado para su documentación. Te recomendamos que averigües qué lenguaje usa la organización que elegiste y que te familiarices con la sintaxis. Markdown es un buen comienzo, ya que los archivos README de GitHub usan una variante de Markdown. Consulta la guía de GitHub sobre Markdown.

Averigua si la organización elegida ya aloja su documentación en un sitio web y, de ser así, qué plataforma usa. La plataforma puede ser un generador de sitios estático, como Jekyll, Sphinx o Hugo, o la organización puede alojar sus documentos en Leer los documentos o las páginas de GitHub. Cuando hayas descubierto qué usa la organización de la plataforma, explora y experimenta con el lenguaje y el framework relevantes. Esto te ayuda a comenzar rápidamente con tu proyecto de código abierto y te coloca en un buen lugar para brindar consejos de sonido al proyecto de código abierto que elijas.

¿Qué lenguajes de programación debo conocer para participar en Season of Docs?

Según la naturaleza de tu proyecto de documentación, es posible que debas familiarizarte con un lenguaje de programación. Ten esto en cuenta cuando elijas y propongas un proyecto de documentación y consulta a la organización de código abierto sobre el nivel de familiaridad requerido.

¿Puedo enviar más de una propuesta de proyecto?

Sí, pero solo se aceptará una propuesta de proyecto por escritor técnico. Consulta la guía para crear tu aplicación.

¿Pueden los escritores técnicos que ya trabajan en un proyecto de código abierto seguir haciéndolo como parte de la temporada de Documentos?

Sí, pero debes tener en cuenta tu relación previa con el proyecto en la propuesta.

¿Puede un grupo enviar una propuesta en conjunto para trabajar en un solo proyecto?

No, solo una persona puede trabajar en un proyecto determinado.

¿Puedo comunicarme directamente con las organizaciones de mentoría antes de enviar una propuesta a Season of Docs?

Sí, puedes comunicarte directamente con la organización de código abierto con la que te interesa trabajar antes de enviar tu postulación a Season of Docs. Los mentores de código abierto pueden ayudarte a definir mejor la idea de tu proyecto.

¿Cuáles son los requisitos de elegibilidad para participar?

  • Debe tener al menos 18 años de edad para registrarse.
  • Debes reunir los requisitos para trabajar en el país en el que residas durante el programa.
  • Debes residir en un país que no esté sujeto a embargos por los Estados Unidos. Consulta las reglas del programa y la Información por país y programas de sanciones del Tesoro de EE.UU.

¿Se hará una excepción a los requisitos de elegibilidad por mí?

No. No podemos hacer excepciones si no cumples con los requisitos de elegibilidad, sin importar qué tan talentoso o interesado seas. Hacer una excepción por ti no sería justo para los otros escritores técnicos que solicitan participar en la temporada de Documentos.

¿Qué formularios debo proporcionar?

Los participantes aceptados deberán proporcionar los formularios fiscales adecuados.

¿Necesito experiencia o capacitación previa como escritor técnico?

Se recomienda contar con experiencia o capacitación previa en redacción técnica, pero no esencial. Cuando envías una propuesta de proyecto, puedes describir tu experiencia o capacitación en redacción técnica. Debes poder proporcionar alguna evidencia que demuestre tu interés en la documentación técnica o de código abierto, incluidos ejemplos de documentación que hayas escrito. El programa Temporada de Documentos tiene como objetivo asociar escritores técnicos experimentados o en formación con mentores de código abierto, para que cada uno pueda aprender de los demás. La organización de código abierto buscará escritores técnicos con el nivel de experiencia que la organización necesita para garantizar la finalización correcta de sus proyectos de la temporada de Documentos.

¿Me pagarán por participar en la temporada de Documentos?

Sí. Google otorgará un subsidio a los escritores técnicos que completen con éxito el programa. Puedes optar por no recibir el subsidio. Consulta los detalles del recargo del escritor técnico.

¿Me pagarán incluso si la organización no usa mi documentación o código?

Sí, siempre que tu proyecto pase la evaluación final del mentor de código abierto. Aunque el proyecto de código abierto use la documentación o el código producidos, esto no afecta el pago del subsidio del escritor técnico.

¿Cómo es una buena propuesta de escritor técnica?

Las mejores propuestas son de escritores técnicos que se toman el tiempo para interactuar y analizar sus ideas con la organización de código abierto que eligieron antes de enviar sus solicitudes de temporada de Documentos. Consulta la guía para crear tu aplicación.

¿Cuánto tiempo lleva participar en Documentos durante la temporada?

La cantidad de tiempo que dediques depende de la naturaleza del proyecto que hayas acordado con tu organización de mentores. El requisito de la cantidad de horas es deliberadamente flexible para permitir diferentes tipos de proyectos y estilos de trabajo diferentes. En promedio, los escritores técnicos dedican entre 20 y 30 horas a la semana.

Antes de enviar tu propuesta de proyecto, debes evaluarlo y analizar una estimación de tiempo con la organización de código abierto. Si te resulta difícil invertir la cantidad de tiempo acordada debido a otros compromisos, hay una opción para completar el proyecto en un período más largo y, aun así, recibir la remuneración y la confirmación del trabajo realizado. Cuando envíes tu aplicación de Temporada de Documentos, especifica la opción de un proyecto de larga duración.

Estoy estudiando comunicación técnica, pero aún no tengo experiencia laboral. ¿Aún puedo participar?

Sí. Al enviar la propuesta de proyecto, enumera los cursos de tu universidad en la sección para conocer la experiencia laboral anterior.

Soy estudiante aceptado en Estados Unidos que tengo una visa F1. ¿Cómo puedo obtener la autorización para participar?

Comunícate con la oficina de asuntos internacionales de estudiantes de tu institución educativa para obtener más detalles. Google no puede proporcionarte ningún tipo de autorización CPT o OPT.

Todos los participantes aceptados recibirán una confirmación por correo electrónico. No ofrecemos letras personalizadas.

¿Cómo usa Season of Docs la información de mi formulario de solicitud?

Los administradores del programa de Google pasan parte de la información de tu aplicación a los administradores de la organización de código abierto que elegiste para que la organización pueda evaluar tu propuesta de proyecto.

Si tu proyecto se acepta en el programa, Season of Docs publicará los detalles del proyecto en el sitio web.

Consulta la descripción del uso de datos en la guía del formulario de solicitud para el escritor técnico.

¿Puedo participar como escritor técnico en Season of Docs y como estudiante en Google Summer of Code?

Aunque esto no va en contra de las reglas, recomendamos enfáticamente que los estudiantes aceptados en Google Summer of Code no se postulen a los horarios disponibles de escritores técnicos de la temporada de Documentos. Los alumnos deben concentrarse en el trabajo de Google Summer of Code en lugar de postularse a Season of Docs.

Para mentores de código abierto y administradores de organizaciones

Quiero obtener más información sobre cómo participar como mentor en Season of Docs. ¿Dónde puedo encontrar más información?

Lee la guía para mentores y las reglas del programa a fin de obtener más información sobre cómo convertirte en mentor de la temporada de Documentos.

¿Cuáles son los requisitos de elegibilidad para una organización de asesoramiento?

Para poder participar como organización de asesoramiento, debes ser un grupo que ejecute un proyecto activo de software libre o de código abierto, como BRL-CAD. No es necesario que el proyecto sea una entidad con incorporación legal. Las organizaciones de mentor ya deben haber producido y lanzado software bajo una licencia aprobada por la iniciativa de código abierto y tener al menos dos colaboradores que sean administradores de la organización o mentores en todo el programa Season of Docs para participar en el programa.

Consulta también los requisitos de elegibilidad que se describen en las reglas del programa y la Información por país y programas de sanciones del Tesoro de EE.UU.

¿El término “organización” es equivalente a un proyecto de código abierto?

Una organización puede tener uno o más proyectos de código abierto. Algunas organizaciones, como las fundaciones, pueden tener varias suborganizaciones, cada una de las cuales tiene uno o más proyectos de código abierto. Si tu organización tiene suborganizaciones independientes, aclara esta información en tu solicitud. Por ejemplo, el lenguaje de programación "Foo" podría aplicarse a la documentación para el lenguaje en su conjunto, así como para los complementos, las bibliotecas o los módulos utilizados con el lenguaje.

¿Las organizaciones reciben dinero por participar en Season of Docs?

Las organizaciones en regla recibirán un subsidio por cada escritor técnico aceptado al final del programa. Esto ocurre independientemente de si el proyecto del escritor técnico es exitoso o no. Las organizaciones pueden usar los fondos como deseen.

¿Cómo asignan los administradores de programas de Google horarios para proyectos de redacción técnica?

La temporada 2020 de la temporada de Documentos se limita a un máximo de 50 proyectos de escritura técnica en total.

A modo de lineamiento, esperamos aceptar un máximo de 2 proyectos por organización para que no terminemos con demasiados proyectos aceptados. Sin embargo, si el proceso de selección gratuita no ocupa todas las ranuras, los administradores del programa de Google pueden asignar ranuras adicionales a algunas organizaciones.

Por lo tanto, cuando envías tu selección de proyectos de escritura técnica, puedes seleccionar más de 2 proyectos. Asegúrate de enumerar tus selecciones en orden de prioridad, con la prioridad principal en la parte superior de la lista.

En tus comunicaciones con los escritores técnicos, debes dejar en claro que el proyecto no se acepta hasta que los administradores del programa de Google publiquen la lista de proyectos aceptados en el sitio web del programa.

¿Se puede revisar una solicitud de una organización antes de la fecha límite de envío?

Lamentablemente, no podemos enviar comentarios sobre la solicitud de la organización.

¿Cómo deben las organizaciones definir el alcance de sus ideas de proyectos?

Muchos proyectos cambiarán de alcance a medida que avancen. Como mentores, debes estar al tanto de cualquier cambio en los proyectos e intentar minimizar la corrupción del alcance y reducir el alcance según corresponda. Al desarrollar ideas de proyectos, intenta encontrar los proyectos más pequeños que brinden valor a la organización (pero se pueden expandir si el tiempo lo permite). Cuanto más pequeña, mejor. Al evaluar las propuestas técnicas del escritor, recomendamos preferir propuestas más pequeñas y detalladas en lugar de proyectos más grandes que sean menos especificados. Si tu proyecto requiere mucha experiencia en el campo, intenta incluir proyectos en los que podría trabajar alguien sin esos antecedentes.

¿Es una auditoría de documentación un proyecto razonable para la temporada de Documentos?

Una auditoría de documentación es un gran proyecto para la temporada de Documentos. Ten en cuenta cuánta documentación ya tienes; si tienes mucha, es posible que debas reducir el alcance (por ejemplo, solo auditar el contenido del instructivo). Si tienes poca o ninguna documentación, es posible que desees incluir la creación de la documentación faltante de mayor prioridad como parte de tu proyecto.

¿Hay plantillas de documentación disponibles para que las organizaciones y escritores técnicos las usen?

The Good Docs Project trabaja para crear algunas plantillas mínimas de documentación viables para el código abierto.

¿Puedo participar en Season of Docs como administrador y mentor de la organización?

Sí. Un administrador de la organización también puede ser un mentor. No necesitas completar un formulario de mentor aparte. Cuando completes el formulario de solicitud de la organización o el formulario de administrador alternativo, debes usar la opción en ese formulario para indicar que también estás actuando como mentor.

¿Puedo participar como administrador o mentor de una organización en Season of Docs y Google Summer of Code?

Sí. La temporada de Documentos y el verano de código de Google son programas separados. No hay problema si tienes el ancho de banda necesario para participar en ambos programas.

¿Puedo participar como administrador o mentor de una organización en Season of Docs y en Google Code-in?

Sí. La temporada de Documentos y Google Code-in son programas separados. No hay problema si tienes el ancho de banda necesario para participar en ambos programas.

Datos archivados

¿Cómo elimino mi información del archivo de la temporada de Documentos?

Comunícate con nosotros para que quitemos tu información.