Skip to content

[Docs] Improve Tutorials#84

Merged
Pabloo22 merged 5 commits intoPabloo22:mainfrom
drQuesadaUPM:docs/source/tutorial
Nov 23, 2025
Merged

[Docs] Improve Tutorials#84
Pabloo22 merged 5 commits intoPabloo22:mainfrom
drQuesadaUPM:docs/source/tutorial

Conversation

@drQuesadaUPM
Copy link
Contributor

Archivos 00 y 01

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @drQuesadaUPM, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

Esta solicitud de extracción actualiza los tutoriales iniciales de instalación, específicamente los archivos 00-Getting-Started.ipynb y 01-How-Solutions-are-Represented.ipynb. El objetivo es mejorar la claridad y el contexto para los usuarios que aprenden sobre el Problema de Programación de Taller y cómo se representan sus soluciones dentro de la biblioteca, proporcionando una base más sólida para comprender los conceptos.

Highlights

  • Actualización del tutorial de inicio (00-Getting-Started.ipynb): Se añadió una definición detallada del Problema de Programación de Taller (JSSP) y se clarificó el propósito de la sección, indicando que la búsqueda de soluciones y optimizaciones se abordará en etapas posteriores.
  • Mejoras en la representación de soluciones (01-How-Solutions-are-Represented.ipynb): Se ajustó el texto introductorio para hacer referencia al ejemplo previo y se incluyeron nuevas celdas de markdown para explicar cómo se organizan las operaciones por máquina, cómo se representa una solución JSSP y la posibilidad de mejorar soluciones manualmente mediante inspección visual.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

Buen trabajo actualizando los tutoriales. Las adiciones de texto y la reorganización del contenido en los notebooks 00-Getting-Started.ipynb y 01-How-Solutions-are-Represented.ipynb mejoran significativamente la claridad y el flujo para los nuevos usuarios. He dejado un par de sugerencias menores para mejorar la redacción en algunas celdas de markdown y hacer el contenido aún más fácil de leer. En general, son cambios muy positivos.

"source": [
"# Getting Started with Job Shop Lib\n",
"\n",
"Recall that the Job Shop Scheduling Problem consists **of determining the optimal sequence of operations for a set of jobs to be processed on a set of machines**, where each job is composed of a series of operations that must be performed in a specific order, and each operation requires a specific machine for a given processing time. The objective is typically to minimize a performance criterion such as the total completion time (makespan) while respecting constraints such as machine capacity (only one job can be processed on a machine at a time) and job precedence relationships.\n",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Este párrafo introductorio es bastante largo y contiene varias ideas. Para mejorar la legibilidad, especialmente para alguien nuevo en el tema, te sugiero dividirlo en oraciones más cortas. Por ejemplo, podrías separar la definición del problema, la descripción de los trabajos y operaciones, y el objetivo de la optimización en frases distintas. Esto haría el texto más fácil de digerir.

Pabloo22 and others added 3 commits October 16, 2025 14:06
Suggestion by gemini

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@codecov-commenter
Copy link

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@Pabloo22 Pabloo22 changed the title Mejora: actualizar tutorial inicial de instalación [Docs] Improve Tutorials Nov 23, 2025
Remove unnecessary .DS_Store files from the repository
@Pabloo22 Pabloo22 merged commit 8c8b75d into Pabloo22:main Nov 23, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants