Skip to content

style: add helper text for experience level - #315

Merged
komalharshita merged 1 commit into
komalharshita:mainfrom
Janvee31:fix-experience-label
May 19, 2026
Merged

style: add helper text for experience level#315
komalharshita merged 1 commit into
komalharshita:mainfrom
Janvee31:fix-experience-label

Conversation

@Janvee31

@Janvee31 Janvee31 commented May 19, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR adds helper text below the “Experience Level” dropdown in the project recommendation form. The change improves UI consistency and provides better guidance to users, matching the behaviour of other fields such as Skills, Area of Interest, and Time Availability.

Related Issue

Closes #264

Type of Change

  • Bug fix — resolves a broken behaviour
  • Feature — adds new functionality
  • Data — adds new projects to data/projects.json
  • Documentation — updates docs, README, or code comments only
  • Style — CSS or visual changes only, no logic change
  • Refactor — restructures code without changing behaviour
  • Test — adds or updates tests

What Was Changed

File Change made
templates/index.html Added helper text below the Experience Level dropdown using the existing form-hint style for consistency

How to Test This PR

  1. 1.Clone this branch: git checkout fix-experience-label
  2. Install dependencies:
  3. Run the app: python app.py
  4. Open: http://127.0.0.1:5000
  5. Scroll to the “Find Your Next Project” form section
  6. Verify that helper text appears below the “Experience Level” dropdown
  7. Run tests: python tests/test_basic.py

Expected test output:

28 passed, 0 failed out of 28 tests

Test Results

PASS test_projects_json_loads
PASS test_each_project_has_required_fields 
PASS test_find_project_by_id_found 
PASS test_find_project_by_id_missing 
PASS test_parse_skills_basic 
PASS test_parse_skills_empty_string 
PASS test_parse_skills_single_entry 
PASS test_score_single_project_full_match 
PASS test_score_single_project_no_match 
PASS test_get_recommendations_returns_results 
PASS test_get_recommendations_max_three 
PASS test_get_recommendations_no_match_returns_empty 
PASS test_get_recommendations_result_format 
PASS test_validate_all_valid 
PASS test_validate_missing_skills 
PASS test_validate_missing_level 
PASS test_validate_missing_interest 
PASS test_validate_missing_time 
PASS test_validate_all_missing 
PASS test_home_route 
PASS test_recommend_api_valid 
PASS test_recommend_api_missing_field 
PASS test_recommend_api_empty_body 
PASS test_project_detail_found 
PASS test_project_detail_not_found 
PASS test_internal_server_error_page 
PASS test_view_code_found 
PASS test_download_code_found 

28 passed, 0 failed out of 28 tests

Screenshots (if UI change)

Before:
Screenshot 2026-05-18 095942
After:
Screenshot 2026-05-19 114359
Screenshot 2026-05-19 114411

Self-Review Checklist

  • I have read CONTRIBUTING.md and followed all guidelines
  • My branch name follows the convention: feat/, fix/, docs/, data/, style/, test/
  • I have run python tests/test_basic.py and all 27 tests pass
  • I have run flake8 . locally and there are no errors
  • I have not introduced any print() or console.log() debug statements
  • Every new function I wrote has a docstring
  • I have not modified files outside the scope of the linked issue
  • If I changed the UI, I tested it at 375px (mobile) and 1280px (desktop)
  • If I added a project to the dataset, it has all required JSON fields

Notes for Reviewer

None

@vercel

vercel Bot commented May 19, 2026

Copy link
Copy Markdown

@Janvee31 is attempting to deploy a commit to the komalsony234-1530's projects Team on Vercel.

A member of the Team first needs to authorize it.

@komalharshita komalharshita left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Good small UX improvement. The added helper text makes the experience level field clearer for users and fits well with the existing form structure.

The implementation is clean, properly scoped, and improves usability without introducing unnecessary changes.

Minor future enhancement suggestion: consider linking the helper text to the select field using aria-describedby for improved accessibility support.

Approved for merge.

@komalharshita
komalharshita merged commit f63c38e into komalharshita:main May 19, 2026
8 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: Missing helper text under “Experience Level” dropdown causing UI inconsistency

2 participants