Skip to main content

Crear un proyecto (beta)

Aprende cómo crear un proyecto, llénalo y agrega campos personalizados.

Los proyectos son una colección personalizable de elementos que se mantienen actualizados con los datos de GitHub. Tus proyectos pueden rastrear propuestas, solicitudes de cambios e ideas que aterrices. Puedes agregar campos personalizados y vistas creativas para propósitos específicos.

Nota: Los proyectos (beta) se encuentran en beta público y están sujetos a cambios.

Crear un proyecto

Crear un proyecto organizacional

  1. En GitHub, navega a la página principal de tu organización.

  2. Haz clic en Proyectos.

  3. Selecciona el menú desplegable de Proyecto nuevo y haz clic en Proyecto nuevo (Beta).

    Proyecto nueuvo

  4. Cuando se pide seleccionar una plantilla, haz clic en alguna o, para iniciar un proyecto vacío, haz clic en "Tabla" o "Tablero". Luego, haz clic en Crear.

    Captura de pantalla que muestra el modo de selección de plantilla

Crear un proyecto de usuario

  1. En cualquier página de GitHub Enterprise Cloud, haz clic en tu avatar y luego selecciona Tus proyectos.

  2. Selecciona el menú desplegable de Proyecto nuevo y haz clic en Proyecto nuevo (Beta).

    Proyecto nueuvo

  3. Cuando se pide seleccionar una plantilla, haz clic en alguna o, para iniciar un proyecto vacío, haz clic en "Tabla" o "Tablero". Luego, haz clic en Crear.

    Captura de pantalla que muestra el modo de selección de plantilla

Actualizar la descripción y el README de tu proyecto

Puedes obtener la descripción y el README de tu proyecto para compartir su propósito, proporcionar instrucciones sobre cómo utilizarlo e incluir cualquier enlace relevante.

  1. Navegar a tu proyecto.
  2. En la parte superior derecha, haz clic en para abrir el menú.
  3. En el menú, haz clic en Ajustes para acceder a los ajustes del proyecto.
  4. Para agregar una descripción corta de tu proyecto, debajo de "Agregar descripción", escribe la descripción en la caja de texto y haz clic en Guardar.
  5. Para actualizar el README de tu proyecto, debajo de "README", teclea tu contenido en la caja de texto.
    • Puedes formatear tu README utilizando lenguaje de marcado. Para obtener más información, consulta "Sintaxis de escritura y formato básicos".
    • Para alternar entre la caja de texto y una vista previa de tus cambios, haz clic en o en .
  6. Para guardar los cambios en tu README, haz clic en Ahorrar.

Puedes ver y hacer cambios rápidos a tu descripción de proyecto y archivo de README si navegas a tu proyecto y haces clic en en la parte superior derecha.

Agregar elementos a tu proyecto

Tu proyecto puede rastrear borradores de propuestas, propuestas, y solicitudes de cambios.

Crear borradores de propuestas

Los borradores de propuestas son útiles si quieres capturar ideas rápidamente.

  1. Coloca tu cursor en la fila inferior del proyecto, junto al .
  2. Teclea tu ida y luego presiona Enter.
  3. Para agregar cuerpo de texto, haz clic en el título del borrador de propuesta. En la caja de entrada de lenguaje de marcado que se muestra, ingresa el texto para el cuerpo del borrador de propuesta y luego haz clic en Guardar.

Los borradores de propuesta pueden tener un título, cuerpo de texto, asignados y cualquier campo personalizado desde tu proyecto. Para poder poblar el repositorio, las etiquetas o hitos de un borrador de propuesta, primero debes convertirla en una propuesta formal. Para obtener más información, consulta la sección "Convertir los borradores de propuesta en propuestas formales".

Nota: Los usuarios no recibirán notificaciones cuando se les asigne o se les mencione en un borrador de propuesta, a menos de que este se convierta en una propuesta formal.

Propuestas y solicitudes de extracción

Pegar la URL de una propuesta o solicitud de cambios

  1. Coloca tu cursor en la fila inferior del proyecto, junto al .
  2. Pega la URL de la propuesta o solicitud de cambios.

Buscar una propuesta o solicitud de cambios

  1. Coloca tu cursor en la fila inferior del proyecto, junto al .
  2. Ingresa #.
  3. Selecciona el repositorio en donde se ubica la solicitud de cambios o propuesta. Puedes teclear la parte del nombre de repositorio para reducir tus opciones.
  4. Selecciona la propuesta o solicitud de cambios. Puedes teclear parte del título para reducir tus opciones.

Agregar propuestas o solicitudes de cambio múltiples desde un repositorio

  1. En GitHub.com, navega al repositorio que contiene las propuestas o solicitudes de cambio que quieras agregar a tu proyecto.
  2. Debajo del nombre de tu repositorio, da clic en Informes de problemas o en Solicitudes de extracción. Selección de la pestaña de propuestas y solicitudes de extracción
  3. A la izquierda de cada título de propuesta, selecciona aquellas que quieras agregar a tu proyecto. Captura de pantalla que muestra una casilla de verificación para seleccionar una propuesta o solicitud de cambios
  4. Opcionalmente, para seleccionar todas las propuestas o solicitudes de cambio en la página, en la parte superior de la lista de propuesta o solicitudes de cambio, selecciona todas. Captura de pantalla que muestra la casilla de verificación para seleccionar todo en la pantalla
  5. Sobre la lista de propuestas o solicitudes de cambio, haz clic en Proyectos (beta). Captura de pantalla que muestra la casilla de verificación para seleccionar todo en la pantalla
  6. Haz clic en los proyectos a los que quieras agregar las propuestas o solicitudes de cambio. Captura de pantalla que muestra la casilla de verificación para seleccionar todo en la pantalla

Asignar un rpoyecto desde dentro de una propuesta o solicitud de cambios

  1. Navega a la propuesta o solicitud de cambios que quieras agregar a un proyecto.

  2. En la barra lateral, haz clic en Proyectos.

  3. Selecciona el proyecto al cual quieras agregar la propuesta o solicitud de cambios.

  4. Opcionalmente, llena los campos personalizados.

    Barra lateral del proyecto

Convertir los borradores de propuestas en propuestas

En el diseño de la tabla:

  1. Haz clic en el en el borrador de propuesta que quieras convertir.
  2. Selecciona Convertir en propuesta.
  3. Selecciona el repositorio al cual quieras agregar la propuesta.
  4. Como alternativa, edita los campos labels, milestone o repository del borrador de propuesta que quieras convertir.

En el diseño del tablero:

  1. Haz clic en el en el borrador de propuesta que quieras convertir.
  2. Selecciona Convertir en propuesta.
  3. Selecciona el repositorio al cual quieras agregar la propuesta.

Eliminar elementos de tu proyecto

Puedes archivar un elemento para mantener el contexto sobre este en el proyecto, pero eliminarlo de las vistas del proyecto. Puedes borrar un elemento para eliminarlo por completo del proyecto.

  1. Selecciona el(los) elemento(s) a archivar o borrar. Para seleccionar elementos múltiples, realiza alguna de las siguientes acciones:
    • Command+Clic (Mac) o Ctrl+Click (Windows/Linux) en cada elemento.
    • Selecciona un elemento y luego presiona Shift+ o Shift+ para seleccionar los elementos adicionales sobre o debajo del que seleccionaste inicialmente.
    • Selecciona un elemento y luego presiona Shift+Clic en otro elemento para seleccionar todos los elementos entre dos de ellos.
    • Ingresa Command+A (Mac) o Ctrl+A (Windows/Linux) para seleccionar todos los elementos en una columna en un diseño amplio o todos los elementos en un diseño de tabla.
  2. Para archivar todos los elementos seleccionados, ingresa E. Para borrar todos los elementos seleccionados, ingresa Del. Como alternativa, selecciona el (en el diseño de tabla) o el (en el diseño de tablero) y luego selecciona la acción deseada.

Puedes restablecer los elementos archivados, pero no los borrados. Para obtener más información, consulta la sección de Cómo restaurar los elementos archivados.

Restaurar los elementos archivados

  1. Navegar a tu proyecto.

  2. En la parte derecha, haz clic en .

  3. En el menú, haz clic en Elementos archivados.

  4. Opcionalmente, para filtrar los elementos archivados que se muestran, teclea tu filtro en la caja de texto superior a la lista de elementos. Para obtener más información sobre los filtros disponibles, consulta la sección "Filtrar proyectos (beta)".

    Captura de pantalla que muestra un campo para filtrar los elementos archivados

  5. A la izquierda de cada título de elemento, selecciona aquellos que te gustaría restablecer.

    Captura de pantalla que muestra las casillas de verificación junto a los elementos archivados

  6. Para restablecer los elementos seleccionados, sobre la lista de elementos, haz clic en Restablecer.

    Captura de pantalla que muestra el botón "Restablecer"

Agregar campos

Conforme cambian los valores de los campos, estos se sincronizan automáticamente para que tu proyecto y los elementos que rastrea estén actualizados.

Mostrar campos existentes

Tu proyecto rastrea la información actualizada de las propuestas y solicitudes de cambio, incluyendo cualquier cambio en el título, asignados, etiquetas, hitos, repositorios, revisores y solicitudes de cambio enlazadas. Cuando tu proyecto inicializa, se muestran el "título" y los "asignados"; los otros campos están ocultos. Puedes cambiar la visibilidad de estos campos en tu proyecto.

  1. Para abrir la paleta de comandos del proyecto, presiona Command+K (Mac) o Ctrl+K (Windows/Linux).
  2. Comienza a teclear "show".
  3. Selecciona el comando deseado (por ejemplo: "Show: Repository").

Como alternativa, puedes hacer esto en la IU:

  1. Haz clic en en el encabezado de campo que está hasta la derecha. Aparecerá un menú desplegable con los campos de proyecto. Mostrar u ocultar los campos
  2. Selecciona el(los) campo(s) que quieras desplegar u ocultar. Un indica qué campos se muestran.

Agregar campos personalizados

Puedes agregar campos personalizados a tu proyecto. Los campos personalizados se mostrarán en la bara lateral de las propuestas y solicitudes de cambio en el proyecto.

Los campos personalizados pueden ser de texto, número, fecha, selección simple o iteración:

  • Texto: El valor puede ser cualquier tipo de texto.
  • Número: El valor debe ser un número.
  • Fecha: El valor puede ser una fecha.
  • Selección simple: El valor debe seleccionarse desde un conjunto de valores especificados.
  • Iteración: el valor debe seleccionarse desde un conjunto de rangos de fechas (iteraciones). Las iteraciones pasadas se marcan automáticamente como "completadas" y la iteración que cubre el rango de fecha actual se marca como "actual". Para obtener más información, consulta la sección "Administrar las iteraciones en los proyectos".
  1. Para abrir la paleta de comandos del proyecto, presiona Command+K (Mac) o Ctrl+K (Windows/Linux). Comienza a teclear cualquier parte de "Create new field". Cuando se muestre "Create new field" en la paleta de comandos, selecciónalo.
  2. Como alternativa, haz clic en en el encabezado de campo que está lo más hacia la derecha. Aparecerá un menú desplegable con los campos de proyecto. Haz clic en Campo nuevo.
  3. Se mostrará una ventana emergente para que ingreses la información sobre el campo nuevo. Campo nuevo
  4. En la caja de texto, ingresa un nombre para el campo nuevo.
  5. Selecciona el menú desplegable y haz clic en el tipo deseado.
  6. Si especificaste Selección simple como el tipo, ingresa las opciones.
  7. Si especificaste Iteración como el tipo, ingresa la fecha de inicio de la primera iteración y la duración de la misma. Se crearán tres iteraciones automáticamente y podrás agregar iteraciones adicionales en la página de ajustes del proyecto.

También puedes editar tus campos personalizados.

  1. Navegar a tu proyecto.

  2. En la parte superior derecha, haz clic en para abrir el menú.

  3. En el menú, haz clic en Ajustes para acceder a los ajustes del proyecto.

  4. Debajo de Campos, selecciona aquél que quieras editar.

  5. Para los campos de selección sencilla, puedes agregar, borrar o reordenar las opciones.

  6. Para los campos de iteración, puedes agregar o borrar las iteraciones, cambiar los nombres de estas y cambiar la fecha de inicio y duración de las mismas.

    Para encontrar más información sobre cómo modificar los campos de iteración, consulta "Administrar las iteraciones en los proyectos".

Personalizar tus vistas

Puedes ver tu proyecto como una tabla o tablero, agrupar los elementos por campo, elemento de filtrado y más. Para obtener más información, consulta la sección "Personalizar las vistas de tu proyecto (beta)".

Configurar la automatización integrada

Los proyectos (beta) incluyen flujos de trabajo integrados que puedes utilizar para actualizar el Estado de los elementos con base en ciertos eventos. Por ejemplo, puedes configurar automáticamente el estado a Pendiente cuando se agrega un elemento a tu proyecto o configurarlo en Hecho cuando se cierre una propuesta.

Cuando inicializa tu proyecto, se habilitan dos flujos de trabajo predeterminadamente: Cuando se cierran las propuestas o solicitudes de cambio de tu proyecto, su estado se muestra como Done y cuando estas se fusionan, se muestra también como Done.

Puedes habilitar o inhabilitar los flujos de trabajo integrados de tu proyecto.

  1. Navegar a tu proyecto.
  2. En la parte superior derecha, haz clic en para abrir el menú.
  3. En el menú, haz clic en Flujos de trabajo.
  4. Debajo de Flujos de trabajo predeterminados, haz clic en el flujo de trabajo que quieres editar.
  5. Si el flujo de trabajo puede aplicarse a ambos resultados y solicitudes de cambio, junto a Dónde, verifica el(los) tipo(s) de elemento(s) sobre el(los) cuál(es) quieres actuar.
  6. Junto a Configurar, elige el valor en el cual quieres configurar al estado.
  7. Si el flujo de trabajo se inhabilita, haz clic en el alternador junto a Inhabilitado para habilitarlo.

Agregar tu proyecto a un repositorio

Puedes listar los proyectos relevantes en un repositorio. Solo puedes listar proyectos que le pertenezcan al mismo usuario u organización propietaria del repositorio.

Para que los miembros de los repositorios vean un proyecto que se lista en dichos repositorios, deben tener visibilidad del proyecto. Para obtener más información, consulta las secciones "Administrar la visibilidad de tus proyectos (beta)" y "Administrar el acceso a los proyectos (beta)".

  1. En GitHub, navega a la página principal de tu repositorio.
  2. Haz clic en Proyectos.
  3. Haz clic en Proyectos (Beta) en la barra lateral.
  4. Haz clic en Agregar proyecto.
  5. En la barra de búsqueda que se muestra, busca los proyectos que le pertenezcan al mismo usuario u organización propietaria del repositorio.
  6. Haz clic en un proyecto para listarlo en tu repositorio.