8000 App/docs/TEMPLATE.md at main · dominictb/App · GitHub
[go: up one dir, main page]

Skip to content

Latest commit

 

History

History
133 lines (97 loc) · 4.66 KB

TEMPLATE.md

File metadata and controls

133 lines (97 loc) · 4.66 KB
title Clear Task-Based Title Using the Feature Name (title case)
description A short description of the page's content. This is used for SEO purposes.
keywords
how to primary task
feature name
related task phrases
internalScope Audience is [who this doc is for]. Covers [single clearly defined workflow], does not cover [closely related workflows intentionally excluded].

[This must match the article title exactly]

Briefly explain:

  • What this feature does
  • Why someone would use it
  • The outcome they can expect
  • Any important limitations

Keep this concise and benefit-focused.


Who can use [exact feature name]

Clearly state:

  • Required role (workspace admin, member, domain admin, etc.)
  • Plan limitations (Free, Collect, Control, Track, or Submit plan; annual or pay-per-use subscription)
  • Any permission or workspace setting prerequisites

If this feature depends on another setting: If [the required setting] is not enabled, learn how to enable . If [the required setting] is not enabled, learn how to enable [Dependency Feature]. State explicitly if the feature is limited to one platform: This feature is only available on web. It isn't available on mobile.


How to [complete primary task using exact feature name]

  1. In the navigation tabs (on the left on web, on the bottom on mobile), select Workspaces > [workspace name] > [Section name].
  2. Select [Exact button name, matching the UI].
  3. Configure the required settings.
  4. Select Save or the final action button (for example, Submit, Confirm).

ADD A SCREENSHOT HERE.
Suggestion: Show the full page with the relevant section highlighted.

What happens after you [complete primary task using exact feature name]

Explain:

  • System behavior
  • Notifications triggered
  • Approval or reimbursement impact
  • Sync behavior (if applicable)
  • Billing impact (if applicable)

Be explicit. Avoid vague phrasing.


FAQ

Can members [Common Task Variation Using Feature Name]?

Clear direct answer.

Why can’t I see [Feature Name]?

Explain possible causes:

  • You’re not a workspace admin or workspace owner
  • The feature is not included in your plan
  • The workspace setting is disabled
  • Domain-level restrictions apply

Does [Feature Name] work with [Integration or Related Feature]?

Provide a precise compatibility explanation.

How do I troubleshoot issues with [Feature Name]?

Include only lightweight troubleshooting. If complex troubleshooting is required, link to a separate dedicated article.

0