Docs: Clarify Additional Instructions scope in Social Marketing AI Settings (SM-4096)

[haleyserrano]

JIRA

SM-4096 – Social Marketing Product → AI Settings → Additional Instructions → Helper Text

---

Change Classification

UI/UX change — helper text added to the Additional Instructions field in Social Marketing Individual Product → Settings → AI Settings. The tooltip was removed and replaced with inline helper text that clarifies where the instructions apply.

Repo: Business App docs only. This change is end-user-facing (Social Marketing Premium/PRO). Partner Center is not impacted.

---

Summary of Documentation Updates

File updated: docusaurus/docs/social-marketing/settings/ai-settings.mdx

What changed:

• Added a new Section 2: Additional Instructions documenting the Settings > AI Settings > Additional Instructions field
• The new section clearly states that instructions entered here apply only to Write with AI — not to Social Media Manager or Blogger
• Directs users to Customize Social and Blog Post Instructions in the configuration for Social Media Manager and Blogger preferences
• Updated the article intro list and Summary section to include the new section
• Renumbered AI Knowledge from Section 2 to Section 3

Existing docs updated (no new pages created). The content fit cleanly within the existing ai-settings.mdx page alongside Common Instructions and AI Knowledge.

---

Placement Reasoning

The Additional Instructions field lives under Settings > AI Settings, the same location already documented in this file. Adding it as a new numbered section alongside Common Instructions and AI Knowledge matches the existing structure and keeps all AI Settings configuration in one place.

---

Acceptance Criteria Coverage

Acceptance Criterion	Documented
Helper text clarifies Additional Instructions apply only to Write with AI	✅
Cross-reference to Customize Social and Blog Post Instructions for SMM/Blogger	✅
Tooltip removed (no documentation needed — tooltip content replaced by helper text, now reflected in docs)	✅
Applies to Premium/PRO Social Marketing individual product	✅

---

Figma / Images

No Figma links provided. JIRA attachments were staging-environment media (inaccessible). Documentation written from acceptance criteria text.

---

Skills Used

• Documentation discovery via mcp__github__search_code
• File read via mcp__github__get_file_contents

---

Reviewer Note

The developer who implemented this change is Sathish Arumugam (sarumugam@vendasta.com). Their GitHub username could not be resolved from the session scope — please add them as a reviewer manually if desired.

---

Assumptions / Limitations

• "Additional Instructions" and "Common Instructions" are treated as distinct fields based on the JIRA description. Common Instructions apply to campaigns; Additional Instructions apply to Write with AI only.
• No screenshots were accessible from the JIRA attachments (staging media URLs).

---

@ahnikakuse @haleyserrano @maryam6samadi

---

Generated by Claude Code