Skip to content

Add a job description checklist - #471

Merged
yawboakye merged 1 commit into
developfrom
codex/job-description-checklist
Oct 23, 2026
Merged

yawboakye merged 1 commit into
developfrom
codex/job-description-checklist

Conversation

@yawboakye

Copy link
Copy Markdown
Member

Summary

  • add concise guidance beside the job description editor
  • add a five-item self-review checklist covering context, responsibilities, requirements, collaboration, and success
  • show the guidance when creating or editing a job post
  • keep every checklist item frontend-only so checks are never submitted or saved

Why

A blank Markdown editor does not tell hiring teams what candidates need in order to assess a role. The checklist gives authors a compact definition of a useful description while leaving the actual writing and structure to them.

The job post remains the only persisted record. Checklist inputs deliberately have no name, so they cannot become submitted job attributes.

Verification

  • focused integration tests: 12 runs, 95 assertions, 0 failures
  • bundle exec standardrb app/components/forms/job_description_input.rb packages/hiring/app/definitions/hiring/job_post_definition.rb test/integration/forms_test.rb
  • manually verified the new-post form in light and dark themes

Screenshots

Light theme

Job description editor with its writing checklist in the light theme

Dark theme

Job description editor with its writing checklist in the dark theme

@yawboakye
yawboakye merged commit 04ca3cd into develop Oct 23, 2026
3 checks passed
@yawboakye
yawboakye deleted the codex/job-description-checklist branch October 23, 2026 10:30
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.

2 participants