Skip to content

  • Projects
  • Groups
  • Snippets
  • Help
  • This project
    • Loading...
  • Sign in / Register
S
software-development-docs
  • Overview
    • Overview
    • Details
    • Activity
    • Cycle Analytics
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Charts
  • Issues 0
    • Issues 0
    • List
    • Board
    • Labels
    • Milestones
  • Merge Requests 0
    • Merge Requests 0
  • CI / CD
    • CI / CD
    • Pipelines
    • Jobs
    • Schedules
    • Charts
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Charts
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
  • pem
  • software-development-docs
  • Merge Requests
  • !1

Merged
Opened Jun 26, 2025 by Erika Suarez@esuarez 
  • Report abuse
Report abuse

Update non pendings development rules files

  • Discussion 20
  • Commits 6
  • Changes 14
{{ resolvedDiscussionCount }}/{{ discussionCount }} {{ resolvedCountText }} resolved
  • César Galvis
    @cgalvis started a discussion on an old version of the diff Jun 26, 2025
    Resolved by Erika Suarez Jun 26, 2025
    docs/development-rules/sections/semantic-versioning.md
    1 1 # Versionamiento semántico
    2 2
    3 Para el versionamiento de proyectos de software, se recomienda el uso de las especificaciones del [Versionamiento Semántico](https://semver.org).
    3 Esta sección es de vital importancia cuando corresponde hacer un deploy de alguna de las plataformas desarrolladas por el equipo.
    4
    5 Para el versionamiento de proyectos de software, seeguimos las especificaciones del [Versionamiento Semántico](https://semver.org).
    • César Galvis @cgalvis commented Jun 26, 2025
      Master

      Porfa, cambiar la palabra a seguimos

      Porfa, cambiar la palabra a `seguimos`
    • Erika Suarez @esuarez

      changed this line in version 2 of the diff

      Jun 26, 2025

      changed this line in version 2 of the diff

      changed this line in [version 2 of the diff](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=246&start_sha=68e65afac10550ae163d714627a91510badab473#d2ccf38cd9e1f8213f931785402f86daa3e177d4_5_5)
      Toggle commit list
    Please register or sign in to reply
  • César Galvis
    @cgalvis started a discussion on an old version of the diff Jun 26, 2025
    Resolved by Erika Suarez Jun 26, 2025
    docs/development-rules/sections/tickets.md
    1 1 # Tareas (*tickets*)
    2 Se tendrán tarea para todas las actividades que involucren una de las siguientes consideracioens:
    • César Galvis @cgalvis commented Jun 26, 2025
      Master

      Porfa, cambiar tarea por tareas y corregir la palabra consideraciones

      Porfa, cambiar `tarea` por `tareas` y corregir la palabra `consideraciones`
    • Erika Suarez @esuarez

      changed this line in version 2 of the diff

      Jun 26, 2025

      changed this line in version 2 of the diff

      changed this line in [version 2 of the diff](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=246&start_sha=68e65afac10550ae163d714627a91510badab473#e41065747ce5b83d9f0dd46fb184c24851064605_2_2)
      Toggle commit list
    Please register or sign in to reply
  • César Galvis
    @cgalvis started a discussion on an old version of the diff Jun 26, 2025
    Resolved by Erika Suarez Jun 26, 2025
    docs/development-rules/sections/tickets.md
    1 1 # Tareas (*tickets*)
    2 Se tendrán tarea para todas las actividades que involucren una de las siguientes consideracioens:
    • César Galvis @cgalvis commented Jun 26, 2025
      Master

      Porfa, cambiar tarea por tareas y corregir la palabra consideraciones

      Porfa, cambiar `tarea` por `tareas` y corregir la palabra `consideraciones`
    • Erika Suarez @esuarez

      changed this line in version 2 of the diff

      Jun 26, 2025

      changed this line in version 2 of the diff

      changed this line in [version 2 of the diff](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=246&start_sha=68e65afac10550ae163d714627a91510badab473#e41065747ce5b83d9f0dd46fb184c24851064605_2_2)
      Toggle commit list
    Please register or sign in to reply
  • César Galvis
    @cgalvis started a discussion on an old version of the diff Jun 26, 2025
    Resolved by Erika Suarez Jun 26, 2025
    docs/development-rules/sections/tickets.md
    1 1 # Tareas (*tickets*)
    2 Se tendrán tarea para todas las actividades que involucren una de las siguientes consideracioens:
    3 - Corresponde al diagnístico o corrección de un error en una de las plataformas
    • César Galvis @cgalvis commented Jun 26, 2025
      Master

      Porfa, cambiar la palabra a diagnóstico

      Porfa, cambiar la palabra a `diagnóstico`
    • Erika Suarez @esuarez

      changed this line in version 2 of the diff

      Jun 26, 2025

      changed this line in version 2 of the diff

      changed this line in [version 2 of the diff](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=246&start_sha=68e65afac10550ae163d714627a91510badab473#e41065747ce5b83d9f0dd46fb184c24851064605_3_2)
      Toggle commit list
    Please register or sign in to reply
  • César Galvis
    @cgalvis started a discussion on an old version of the diff Jun 26, 2025
    Resolved by Erika Suarez Jun 26, 2025
    docs/development-rules/sections/tickets.md
    1 1 # Tareas (*tickets*)
    2 Se tendrán tarea para todas las actividades que involucren una de las siguientes consideracioens:
    3 - Corresponde al diagnístico o corrección de un error en una de las plataformas
    4 - Corresponde a una investicación (*[spipke]*) o a una prueba (*[POC]*) relacionada a algún compromiso de la línea
    • César Galvis @cgalvis commented Jun 26, 2025
      Master

      Porfa, cambiar la palabra a spike

      Porfa, cambiar la palabra a `spike`
    • Erika Suarez @esuarez

      changed this line in version 2 of the diff

      Jun 26, 2025

      changed this line in version 2 of the diff

      changed this line in [version 2 of the diff](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=246&start_sha=68e65afac10550ae163d714627a91510badab473#e41065747ce5b83d9f0dd46fb184c24851064605_4_2)
      Toggle commit list
    Please register or sign in to reply
  • César Galvis
    @cgalvis started a discussion on an old version of the diff Jun 26, 2025
    Resolved by Erika Suarez Jun 26, 2025
    docs/development-rules/sections/tickets.md
    35 * Al empezar a trabajar en una tarea, se debe pasar al pipeline “*In Progress*”. La tarea se mantendrá ahí a menos que por diferentes razones no se pueda seguir trabajando en ella, en cuyo caso pasará de nuevo a “*Todo*”.
    36 * Cuando no es necesario realizar una tarea (empezar o terminar), se debe cambiar su estado a *Canceled*.
    37 * Al crear un *PR* se debe asociar la tarea correspondiente. Esto automáticamente pasará la tarea al *pipeline* “*In Review”. De este estado solo vuelve a “*In Progress*” si los cambios solicitados son grandes.
    38 * Tener en cuenta que al cerrar un PR asociado a una tarea, esta se marca automaticamnnte como completada (Estado *Done*), en algunos casos se deberá mantener abierta hasta finalizar otras cosas (por ejemplo documentación)
    • César Galvis @cgalvis commented Jun 26, 2025
      Master

      Porfa, corregir la palabra a automáticamente

      Porfa, corregir la palabra a `automáticamente`
    • Erika Suarez @esuarez

      changed this line in version 2 of the diff

      Jun 26, 2025

      changed this line in version 2 of the diff

      changed this line in [version 2 of the diff](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=246&start_sha=68e65afac10550ae163d714627a91510badab473#e41065747ce5b83d9f0dd46fb184c24851064605_38_39)
      Toggle commit list
    Please register or sign in to reply
  • César Galvis @cgalvis commented Jun 26, 2025
    Master

    Buenos días Erika.

    Muchas gracias por tus aportes. Agregué algunas notas para corregir unas palabras, pero considero que está bien.

    La verdad prefiero tener los diagramas de draw.io como SVG para ver mejor las diferencias entre commits, pero lo podemos manejar como PNG mientras se actualiza el Gitlab privado.

    Buenos días Erika. Muchas gracias por tus aportes. Agregué algunas notas para corregir unas palabras, pero considero que está bien. La verdad prefiero tener los diagramas de draw.io como SVG para ver mejor las diferencias entre commits, pero lo podemos manejar como PNG mientras se actualiza el Gitlab privado.
  • Manuel Galvez
    @mgalvez started a discussion on the diff Jun 26, 2025
    Resolved by Erika Suarez Jun 26, 2025
    docs/development-rules/sections/tickets.md
    1 1 # Tareas (*tickets*)
    2 Se tendrán tarea para todas las actividades que involucren una de las siguientes consideracioens:
    3 - Corresponde al diagnístico o corrección de un error en una de las plataformas
    4 - Corresponde a una investicación (*[spipke]*) o a una prueba (*[POC]*) relacionada a algún compromiso de la línea
    5 - Es una responsabilidad que tiene un resultado concreto (por ejemplo un PR, MR o un documento)
    2 6
    3 Todo nuevo requerimiento o error de un sistema debe ser debidamente documentado en un sistema de *tickets* y estar asignado a un integrante del equipo de desarrollo.
    7 Ejemplos de actividades que no se manejan con tareas en el tablero del equipo:
    8 - Apoyo en un proceso de selección (por ejemplo revisión de pruebas, hojas de vida o entrevistas)
    9 - Apoyo en algún proceso o problema que tengan en otra línea (por ejemplo revisión de algún código, una consulta rápida en base de datos)
    10 - Levantar un servicio caído
    11 - Asistir a reuniones de futuros proyectos o convenios
    12
    • Manuel Galvez @mgalvez commented Jun 26, 2025
      Master

      Aquí también deberiamos agregar las táreas que surgen de la supervisión?

      Aquí también deberiamos agregar las táreas que surgen de la supervisión?
    • Erika Suarez @esuarez commented Jun 26, 2025
      Master

      De acuerdo, hasta la elaboración de TDRs es una cosa larga que no se puede condensar en un sprint y el documento final muchas veces ni nos sirve porque cada abogado sale con sus raras

      De acuerdo, hasta la elaboración de TDRs es una cosa larga que no se puede condensar en un sprint y el documento final muchas veces ni nos sirve porque cada abogado sale con sus raras
    • Erika Suarez @esuarez commented Jun 26, 2025
      Master

      revisa la línea agregada a ver

      revisa la línea agregada a ver
    • Manuel Galvez @mgalvez commented Jun 26, 2025
      Master

      Estoy de acuerdo, creo que es clara y concisa.

      Estoy de acuerdo, creo que es clara y concisa.
    Please register or sign in to reply
  • Erika Suarez @esuarez

    added 2 commits

    • 36e56c02 - fix typos
    • 6e6069d2 - add missing example

    Compare with previous version

    Jun 26, 2025

    added 2 commits

    • 36e56c02 - fix typos
    • 6e6069d2 - add missing example

    Compare with previous version

    added 2 commits * 36e56c02 - fix typos * 6e6069d2 - add missing example [Compare with previous version](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=246&start_sha=68e65afac10550ae163d714627a91510badab473)
    Toggle commit list
  • Erika Suarez @esuarez

    added 1 commit

    • 5a3ab8d2 - fix typo

    Compare with previous version

    Jun 26, 2025

    added 1 commit

    • 5a3ab8d2 - fix typo

    Compare with previous version

    added 1 commit * 5a3ab8d2 - fix typo [Compare with previous version](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=247&start_sha=6e6069d2cff1351e6dd74b2f1e87a312d85e4f61)
    Toggle commit list
  • César Galvis
    @cgalvis started a discussion on an old version of the diff Jun 26, 2025
    Last updated by Erika Suarez Jun 28, 2025
    docs/development-rules/sections/code-versioning.md
    108 1. Seleccionar la rama *main*/*master* para crear el lanzamiento
    109 2. Asignar la etiqueta de la forma: **\<\#1\>.\<\#2\>.\<\#3\>** (ver [Versionamiento semántico](semantic-versioning.md))
    110 3. Asignar el título de la versión de la forma: **\<\#1\>.\<\#2\>.\<\#3\>**
    111 4. En la descripción del lanzamiento, redactar los cambios de la nueva versión teniendo en cuenta los siguiente:
    112 1. No especificar cada commit ni cada tarea, solo los cambios en funcionalidades completas.
    113 2. No detallar cambios técnicos. Por ejemplo, solo “*dependency update*” en lugar de listar todas las dependencias que se cambiaron
    114
    115
    116 [^1]: [Editable para el diagrama de las ramas feature](https://drive.google.com/drive/folders/12YStpH9Y7vrZcBHs8i9sfnPyG7LlWI7l)
    • César Galvis @cgalvis commented Jun 26, 2025
      Master

      No había visto esto. No sé si es necesario agregar los enlaces de los diagramas aquí, ya que estos diagramas ya están en el repositorio y son editables con el complemento de vscode hediet.vscode-drawio

      No había visto esto. No sé si es necesario agregar los enlaces de los diagramas aquí, ya que estos diagramas ya están en el repositorio y son editables con el complemento de vscode `hediet.vscode-drawio`
    • Erika Suarez @esuarez commented Jun 26, 2025
      Master

      no lo sabía, pero no me parece que debamos ser dependientes de vscode. Creo que es mejor seguirlo manejando en el drive y que cada uno use el editor que prefiera.

      no lo sabía, pero no me parece que debamos ser dependientes de vscode. Creo que es mejor seguirlo manejando en el drive y que cada uno use el editor que prefiera.
    • César Galvis @cgalvis commented Jun 26, 2025
      Master

      También se pueden editar con el programa de escritorio: https://www.drawio.com/

      También se pueden editar con el programa de escritorio: https://www.drawio.com/
    • Jorge Higuita @jhiguita commented Jun 26, 2025
      Master

      Creo que por estandarizar las herramientas deberíamos todos usar lo mismo, en este caso drawio. Ya el caso del editor de código pues ese si debe ser a elección de cada miembro del equipo.

      Creo que por estandarizar las herramientas deberíamos todos usar lo mismo, en este caso drawio. Ya el caso del editor de código pues ese si debe ser a elección de cada miembro del equipo.
    • Erika Suarez @esuarez commented Jun 26, 2025
      Master

      listo, mi punto de mantenerlo en el drive era por la edición con drawio, pero sí es mejor mantener solo una versión y me parece bien que sea acá. Lo que me parece aún más interesante es que a partir del png se pueda editar sin problema

      listo, mi punto de mantenerlo en el drive era por la edición con drawio, pero sí es mejor mantener solo una versión y me parece bien que sea acá. Lo que me parece aún más interesante es que a partir del png se pueda editar sin problema
    • Erika Suarez @esuarez commented Jun 27, 2025
      Master

      A raíz de lo que mencioné en el comentario anterior agregué una pequeña linea en la documentación sobre drawio, para mi fue difícil asumir eso 😅

      A raíz de lo que mencioné en el comentario anterior agregué una pequeña linea en la documentación sobre drawio, para mi fue difícil asumir eso 😅
    • Erika Suarez @esuarez

      changed this line in version 4 of the diff

      Jun 28, 2025

      changed this line in version 4 of the diff

      changed this line in [version 4 of the diff](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=249&start_sha=5a3ab8d213201b23f2331d2776b8b2763bf585b6#be5c5f6deead0cc1fbd049b7049f5b158db2fdec_116_116)
      Toggle commit list
    Please register or sign in to reply
  • Camilo Zapata
    @czapata started a discussion on an old version of the diff Jun 27, 2025
    Resolved by Erika Suarez Jun 27, 2025
    docs/development-rules/sections/semantic-versioning.md
    12 * El número **X** indicará un número de versión mayor, corresponde a cambios que no tienen compatibilidad con versiones anteriores (por ejemplo, un cambio completo de una API)
    13 * El número **Y** indicará un número de versión menor, indica cambios compatible con versiones anteriores (por ejemplo, nuevas características o ajustes de bugs no prioritarios)
    14 * El número **Z** indicará un número de parche, lo que se denomita un `hotfix` en inglés.
    • Camilo Zapata @czapata commented Jun 27, 2025
      Master

      typo denomita

      typo `denomita`
    • Erika Suarez @esuarez

      changed this line in version 4 of the diff

      Jun 28, 2025

      changed this line in version 4 of the diff

      changed this line in [version 4 of the diff](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=249&start_sha=5a3ab8d213201b23f2331d2776b8b2763bf585b6#d2ccf38cd9e1f8213f931785402f86daa3e177d4_14_14)
      Toggle commit list
    Please register or sign in to reply
  • Camilo Zapata
    @czapata started a discussion on an old version of the diff Jun 27, 2025
    Last updated by Erika Suarez Jun 28, 2025
    docs/development-rules/sections/tools-and-frameworks.md
    1 1 # Herramientas y frameworks
    2 2
    3 El uso de diferentes herramientas y frameworks será determinado para cada proyecto, en conjunto con los miembros del equipo, a continuación se presentan algunas recomendaciones generales.
    4
    3 5 ## Back end
    4 6
    5 7 Un proyecto de back end debe:
    6 8
    7 * Tener compatibilidad total con el sistema operativo *GNU/Linux* (para facilitar su contenerización y orquestación).
    9 * Tener compatibilidad total con el sistema operativo *GNU/Linux* (para facilitar su contenerización y orquestación).
    • Camilo Zapata @czapata commented Jun 27, 2025
      Master

      Me parece que esta aclaración aplica no solo para el back, si no para el front y demas componentes.

      Me parece que esta aclaración aplica no solo para el back, si no para el front y demas componentes.
    • Erika Suarez @esuarez commented Jun 27, 2025
      Master

      de acuerdo, lo puse en una nueva sección de recomendaciones generales

      de acuerdo, lo puse en una nueva sección de recomendaciones generales
    • Erika Suarez @esuarez

      changed this line in version 4 of the diff

      Jun 28, 2025

      changed this line in version 4 of the diff

      changed this line in [version 4 of the diff](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=249&start_sha=5a3ab8d213201b23f2331d2776b8b2763bf585b6#b529055f923769f214ae2b1537ebb64146f828b7_9_12)
      Toggle commit list
    Please register or sign in to reply
  • Erika Suarez @esuarez

    added 2 commits

    • 689799b2 - apply suggested changes
    • 7d25ddd6 - add some explanations and links

    Compare with previous version

    Jun 28, 2025

    added 2 commits

    • 689799b2 - apply suggested changes
    • 7d25ddd6 - add some explanations and links

    Compare with previous version

    added 2 commits * 689799b2 - apply suggested changes * 7d25ddd6 - add some explanations and links [Compare with previous version](http://gitlab.example.com/pem/software-development-docs/merge_requests/1/diffs?diff_id=249&start_sha=5a3ab8d213201b23f2331d2776b8b2763bf585b6)
    Toggle commit list
  • Erika Suarez @esuarez

    merged

    Jul 01, 2025

    merged

    merged
    Toggle commit list
  • Erika Suarez @esuarez

    mentioned in commit edd5ec20

    Jul 01, 2025

    mentioned in commit edd5ec20

    mentioned in commit edd5ec2069038249a872593773365469c3049bcd
    Toggle commit list
  • Write
  • Preview
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment
Assignee
No assignee
Assign to
None
Milestone
None
Assign milestone
Time tracking
Reference: pem/software-development-docs!1
×

Revert this merge request

Switch branch
Cancel
A new branch will be created in your fork and a new merge request will be started.
×

Cherry-pick this merge request

Switch branch
Cancel
A new branch will be created in your fork and a new merge request will be started.