ComBuildersES / ComBuildersES/gestion-interna

Crear repo template (en GitHub) para nuevas iniciativas

Open
#3 0 comments 0 reactions 0 assignees View on GitHub
priority/medium rol/admin
Dominant language
No language data
Stars
0
Forks
1
PR merge metrics
No merged PRs in 30d

Description

En Trello teníamos un [template card](https://trello.com/c/IGZ4feB6/58-crear-nuevo-repo-template-en-github), ahora lo suyo sería tener un [repository template](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-template-repository).

Yo pienso que en base a las lecciones aprendidas de la información que estamos incluyendo en las iniciativas actuales deberíamos extraer una estructura que pudiésemos reutilizar.

De ahí el repo debería contar con una estructura básica (README.md, CONTRIBUTING.md, ...) y que cada fichero tuviese las reglas mínimas a seguir, por ejemplo:
* El fichero README.md: debería contener el propósito del proyecto, un encabezado apuntando al contributing, otro con los contribuyentes (indicando si hay que usar el bot "[allcontributors](https://github.com/all-contributors/all-contributors)" para automatizar la incorporación de personas a la lista), etc.
* El fichero CONTRIBUTING.md: Incluir las instrucciones/sugerencias de cómo se usan los issue templates, discussions, roles y *contributing path*, cómo se tomas las decisiones, etc en otras iniciativas de la comunidad (`GOVERNANCE.md`?)
* El fichero license: Apache 2.0 para projectos de software o CC 4.0 BY para proyectos de documentación
* Y además debería de incluir un enlace a la guía/documentación sobre cómo empezar proyectos ([ver issue](https://github.com/ComBuildersES/gestion-interna/issues/4#issue-3031813793))

> Nota: Quizás también podamos reutilizar las [guías de GitHub](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions) para sacar ideas.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing the linked Trello card, issue 4, and GitHub's healthy-contributions guide to extract the common initiative practices. Define the template structure around README.md, CONTRIBUTING.md, GOVERNANCE.md, issue and discussion guidance, and the appropriate license files. Done means a reusable GitHub repository template documents these conventions and links to the project-starting guide.

Written by the indexing model from the issue text.

Assessment

Tech stack
github
Domain
developer-experience, documentation, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.