How Yousuccess articles, guides, and briefs work

Use this template for help articles, onboarding guides, knowledge base content, and brief education pages. The structure is designed to keep support content readable, searchable, and consistent across the marketplace while preserving a clean two-column documentation layout.

Getting started

This article template is intended for marketplace knowledge content, including freelancer guides, buyer instructions, policy explainers, workflow documentation, and brief education. It provides a stable shell for long-form informational pages with consistent navigation and section hierarchy.

• This feature is available on desktop and mobile web for long-form marketplace guidance.
• Use consistent headings so the quick links sidebar can map the article sections correctly.
• Keep articles action-oriented and aligned to the sequence users follow.

How to use the template

1. Create the article using a clear title that matches the user task.
2. Write a short overview explaining the outcome before the steps begin.
3. Add section headings for every major topic so the quick links sidebar updates automatically.
4. Use tabs, callouts, lists, and FAQs only where they improve clarity.
5. Review the article on desktop and mobile before publishing.

Best practices

• Include enough context for users to act without opening multiple extra pages.
• Maintain proper case, moderate spacing, and clean typography across every section.
• Avoid oversized headings, noisy borders, or cards that interrupt reading flow.
• Use short callouts for critical instructions and policy-sensitive points.

Navigation and related content

Each article should support quick scanning and easy movement into connected documentation. Use related articles, previous and next links, and a simple helpfulness prompt where appropriate.

FAQs