ComBuildersES / ComBuildersES/gestion-interna
Crear repo template (en GitHub) para nuevas iniciativas
- 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