Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Integrated Code Lifecycle: imporve auxiliary repository tool tip #9525

Conversation

SimonEntholzer
Copy link
Contributor

@SimonEntholzer SimonEntholzer commented Oct 19, 2024

Checklist

General

Client

  • I added multiple screenshots/screencasts of my UI changes.
  • I translated all newly inserted strings into English and German.

Changes affecting Programming Exercises

  • High priority: I tested all changes and their related features with all corresponding user types on a test server configured with the integrated lifecycle setup (LocalVC and LocalCI).
  • I tested all changes and their related features with all corresponding user types on a test server configured with Gitlab and Jenkins.

Motivation and Context

We want the same behaviour for all repository types, on how they are injected before the build process.

Description

Add a tooltip informing how auxiliary repositories are injected.

Steps for Testing

Create a new porgramming exercise and check the tool tip for auxiliary repositories

Testserver States

Note

These badges show the state of the test servers.
Green = Currently available, Red = Currently locked
Click on the badges to get to the test servers.







Review Progress

Performance Review

  • I (as a reviewer) confirm that the client changes (in particular related to REST calls and UI responsiveness) are implemented with a very good performance even for very large courses with more than 2000 students.
  • I (as a reviewer) confirm that the server changes (in particular related to database calls) are implemented with a very good performance even for very large courses with more than 2000 students.

Code Review

  • Code Review 1
  • Code Review 2

Manual Tests

  • Test 1
  • Test 2

Test Coverage

Screenshots

image
image

Summary by CodeRabbit

  • New Features

    • Enhanced tooltips for programming exercise information with a maximum width for better readability.
    • Updated descriptions for auxiliary repositories in both German and English localization, providing clearer instructions on their usage and behavior during the build process.
  • Bug Fixes

    • Corrected grammatical inaccuracies in the German description of auxiliary repositories.

@SimonEntholzer SimonEntholzer requested a review from a team as a code owner October 19, 2024 12:09
@SimonEntholzer SimonEntholzer added client Pull requests that update TypeScript code. (Added Automatically!) small labels Oct 19, 2024
Copy link

coderabbitai bot commented Oct 19, 2024

Warning

Rate limit exceeded

@SimonEntholzer has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 3 minutes and 40 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Files that changed from the base of the PR and between b52ee08 and 5ef7749.

Walkthrough

The changes in this pull request involve updates to the CSS styling for tooltips in the programming-exercise-information.component.scss file and modifications to the German and English localization JSON files for the programming exercise module. The CSS update introduces a maximum width for tooltip elements, while the localization updates provide a more detailed explanation of how auxiliary repositories function, including specifics on the insertion process and adjustments needed for build scripts.

Changes

File Change Summary
src/main/webapp/app/exercises/programming/manage/update/update-components/programming-exercise-information.component.scss Added a new CSS rule for the .tooltip-inner class to set a maximum width of 600 pixels.
src/main/webapp/i18n/de/programmingExercise.json Updated auxiliaryRepository.usageDescription with a more detailed explanation of the auxiliary repositories' functionality, including changes in terminology for grammatical accuracy.
src/main/webapp/i18n/en/programmingExercise.json Updated auxiliaryRepository.usageDescription to clarify the process of code insertion from auxiliary repositories, detailing the behavior based on the existence of the checkout directory and the need for build script adjustments.

Possibly related PRs

Suggested labels

documentation, ready to merge, template

Suggested reviewers

  • JohannesStoehr
  • BBesrour
  • coolchock
  • edkaya
  • Hialus

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai or @coderabbitai title anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (1)
src/main/webapp/i18n/de/programmingExercise.json (1)

Line range hint 1-524: Vorschlag zur Verbesserung der Lesbarkeit

Die Datei ist gut strukturiert und verwendet durchgängig die informelle Anrede, was den Coding-Richtlinien entspricht. Um die Lesbarkeit weiter zu verbessern, könnten Sie in Erwägung ziehen, sehr lange Zeilen in der JSON-Datei auf mehrere Zeilen aufzuteilen. Dies würde die Wartbarkeit erhöhen, ohne die Funktionalität zu beeinträchtigen.

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 1b8ad60 and 6819d5f.

📒 Files selected for processing (3)
  • src/main/webapp/app/exercises/programming/manage/update/update-components/programming-exercise-information.component.scss (1 hunks)
  • src/main/webapp/i18n/de/programmingExercise.json (1 hunks)
  • src/main/webapp/i18n/en/programmingExercise.json (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • src/main/webapp/app/exercises/programming/manage/update/update-components/programming-exercise-information.component.scss
🧰 Additional context used
📓 Path-based instructions (1)
src/main/webapp/i18n/de/programmingExercise.json (1)

Pattern src/main/webapp/i18n/de/**/*.json: German language translations should be informal (dutzen) and should never be formal (sietzen). So the user should always be addressed with "du/dein" and never with "sie/ihr".

🔇 Additional comments (2)
src/main/webapp/i18n/en/programmingExercise.json (1)

522-522: Improved description for auxiliary repository usage.

The updated description provides a more detailed explanation of how auxiliary repositories are utilized in programming exercises. It clarifies the insertion process and potential differences based on the existence of the checkout directory.

However, there are a few suggestions to enhance readability and clarity:

  1. Consider breaking the long description into bullet points for easier reading.
  2. The phrase "It is inserted via a mv operation" might be unclear to some users. Consider explaining what "mv" means (move operation) or use a more general term.
  3. The last sentence about adapting the build script to overwrite student files could benefit from more context or a brief explanation of when this might be necessary.

Here's a suggested revision:

-                "usageDescription": "You can use auxiliary repositories to provide additional code that students cannot see or modify. The additional code is inserted at the specified Checkout Directory before the build of the submission. It is inserted via a mv operation. This means, there is a difference on how it is inserted, depending whether the checkout dir already exists or not. If it exists, the repository's content is added at the checkout dir in a new folder with the repository's name. If it does not exist, the checkout dir's folder is created and the auxiliary repositories content is inserted directly there. To overwrite student's files, you need to adapt the build script.",
+                "usageDescription": "You can use auxiliary repositories to provide additional code that students cannot see or modify. The additional code is inserted at the specified Checkout Directory before the build of the submission. Key points:\n\n• The insertion process depends on whether the checkout directory already exists:\n  - If it exists: The repository's content is added in a new folder named after the repository.\n  - If it doesn't exist: A new folder is created, and the auxiliary repository's content is inserted directly.\n\n• The insertion is done using a move operation.\n\n• To overwrite student files with auxiliary content, you may need to modify the build script accordingly."

This revision improves readability and provides a clearer structure to the information.

src/main/webapp/i18n/de/programmingExercise.json (1)

522-522: Gut gemachte Erweiterung der Beschreibung!

Die neue Beschreibung für auxiliaryRepository.usageDescription ist deutlich ausführlicher und informativer. Sie erklärt den Prozess der Einfügung von zusätzlichem Code aus Hilfsrepositorien klar und detailliert. Die Verwendung der informellen Anrede (du/dein) entspricht den Coding-Richtlinien für deutsche Übersetzungen.

coderabbitai[bot]
coderabbitai bot previously approved these changes Oct 19, 2024
Copy link

⚠️ Unable to deploy to test servers ⚠️

Testserver "artemis-test1.artemis.cit.tum.de" is already in use by PR #9519.

@github-actions github-actions bot added the deployment-error Added by deployment workflows if an error occured label Oct 20, 2024
@github-actions github-actions bot removed the deployment-error Added by deployment workflows if an error occured label Oct 20, 2024
@sachmii sachmii temporarily deployed to artemis-test2.artemis.cit.tum.de October 20, 2024 17:38 — with GitHub Actions Inactive
sachmii
sachmii previously approved these changes Oct 20, 2024
Copy link

@sachmii sachmii left a comment

Choose a reason for hiding this comment

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

Tested on TS2, tooltip shows up and works fine.

Copy link
Contributor

@edkaya edkaya left a comment

Choose a reason for hiding this comment

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

LGTM. I left some small adjustments to improve the clarity of the text

src/main/webapp/i18n/en/programmingExercise.json Outdated Show resolved Hide resolved
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (2)
src/main/webapp/i18n/de/programmingExercise.json (2)

Line range hint 524-527: Consider adding more context to some labels

Some labels like "Name des Repositorys" and "Checkout-Verzeichnis" could benefit from additional context or tooltips to enhance user understanding.

Consider adding tooltips or brief descriptions for these fields:

 "repositoryName": "Name des Repositorys",
+"repositoryNameTooltip": "Gib einen eindeutigen Namen für das Hilfs-Repository ein",
 "checkoutDirectory": "Checkout-Verzeichnis",
+"checkoutDirectoryTooltip": "Gib das Verzeichnis an, in dem das Hilfs-Repository ausgecheckt werden soll",
 "description": "Beschreibung",
+"descriptionTooltip": "Füge eine kurze Beschreibung hinzu, um den Zweck dieses Hilfs-Repositories zu erklären"

Line range hint 528-536: Improve clarity of warning messages

The warning messages for auxiliary repositories could be more specific about the manual steps required.

Consider updating the warning messages to provide more actionable information:

-"warning": "Hilfs-Repositories können hinzugefügt, editiert und gelöscht werden. Editierungen wirken sich allerdings nicht auf das VCS und CIS aus und müssen dort manuell durchgeführt werden.",
+"warning": "Hilfs-Repositories können hinzugefügt, editiert und gelöscht werden. Wichtig: Änderungen hier aktualisieren nicht automatisch das VCS und CIS. Bitte führe entsprechende Anpassungen dort manuell durch.",
-"editedWarning": "Du hast die Hilfs-Repositories verändert. Diese Änderungen wirken sich allerdings nicht auf das VCS und CIS aus und müssen dort manuell durchgeführt werden.",
+"editedWarning": "Du hast die Hilfs-Repositories verändert. Bitte beachte: Diese Änderungen aktualisieren nicht automatisch das VCS und CIS. Führe die entsprechenden Anpassungen dort manuell durch, um Konsistenz zu gewährleisten.",
-"editedWarningLocalCI": "Du hast die Hilfs-Repositories verändert. Diese Änderungen wirken sich allerdings nicht auf das VCS und CIS aus und müssen dort manuell durchgeführt werden.",
+"editedWarningLocalCI": "Du hast die Hilfs-Repositories verändert. Wichtig: Diese Änderungen aktualisieren nicht automatisch das lokale VCS und CIS. Stelle sicher, dass du die entsprechenden Anpassungen dort manuell vornimmst."
📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 6819d5f and b52ee08.

📒 Files selected for processing (2)
  • src/main/webapp/i18n/de/programmingExercise.json (1 hunks)
  • src/main/webapp/i18n/en/programmingExercise.json (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • src/main/webapp/i18n/en/programmingExercise.json
🧰 Additional context used
📓 Path-based instructions (1)
src/main/webapp/i18n/de/programmingExercise.json (1)

Pattern src/main/webapp/i18n/de/**/*.json: German language translations should be informal (dutzen) and should never be formal (sietzen). So the user should always be addressed with "du/dein" and never with "sie/ihr".

🔇 Additional comments (2)
src/main/webapp/i18n/de/programmingExercise.json (2)

522-523: Approved: The updated description is clear and informative.

The new description for auxiliaryRepository.usageDescription provides a detailed explanation of how auxiliary repositories work in the context of programming exercises. It correctly uses the informal "du" form as required by the coding guidelines.


Line range hint 1-1000: Overall, the translations are well-implemented and adhere to guidelines.

The file provides comprehensive German translations for the programming exercise module, consistently using the informal "du" form as required. The main change in auxiliaryRepository.usageDescription is clear and informative. Only minor improvements were suggested to enhance clarity and user understanding in some sections.

HawKhiem
HawKhiem previously approved these changes Oct 21, 2024
Copy link

@HawKhiem HawKhiem left a comment

Choose a reason for hiding this comment

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

Tested on TS3. Works as expected!

image

SindiBuklaji
SindiBuklaji previously approved these changes Oct 22, 2024
Copy link

@SindiBuklaji SindiBuklaji left a comment

Choose a reason for hiding this comment

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

Tested on TS4. Works as expected & described! 👍

ole-ve
ole-ve previously approved these changes Oct 22, 2024
Copy link
Contributor

@ole-ve ole-ve left a comment

Choose a reason for hiding this comment

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

code and tested on TS4

flbrgit
flbrgit previously approved these changes Oct 26, 2024
Copy link

@flbrgit flbrgit left a comment

Choose a reason for hiding this comment

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

Tested on TS2 and everything works as described and expected

@SimonEntholzer
Copy link
Contributor Author

#9585 implements the tooltip update

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
client Pull requests that update TypeScript code. (Added Automatically!) small
Projects
Status: Ready For Review
Development

Successfully merging this pull request may close these issues.

8 participants