How to draft a job description from the actual role
A useful job description explains the work, expected outcomes and requirements for a real role. A factual brief helps avoid a long list of generic qualities that does not guide applicants.
Start with the right material.
- What you provide
- a hiring brief with responsibilities and requirements supplied by the employer.
- The intended result
- Save a job description separating required and optional qualifications from supplied facts.
How the workflow works.
Use the supplied responsibilities, reporting context and requirements to organize the draft. Separate essential qualifications from preferences and mark undecided terms such as location or compensation.
What to check in the result.
Review the description with the hiring team and its applicable requirements before publishing. Do not invent benefits, eligibility conditions or restrictions unrelated to the work.
Preview the Markdown to check headings, lists and links as well as the words. Keep source references with the document so a reviewer can trace important statements back to the material you supplied.
Learn from the worked example.
The downloadable Markdown example shows one possible organization of the result. Read it alongside the source example and notice which statements are recorded facts, proposed wording or questions still needing an answer.
The supplied example is illustrative. It is not a recorded run on your data.
Download the example ↓Use it with your own material.
- Open the source you want to work with and activate WebAct on that tab.
- Copy the task from the hero, add any required fields or preferences, and review the proposed actions.
- Compare the first result with your source. Ask for a specific correction or refinement where needed.