139 lines
3.3 KiB
Markdown
139 lines
3.3 KiB
Markdown
# AI Documentation Plan
|
|
|
|
## Purpose
|
|
Create a Confluence-ready hierarchy and an initial documentation set that assumes zero prior knowledge. This plan now maps directly to markdown files under a docs folder.
|
|
|
|
## Proposed Folder Structure
|
|
- docs/
|
|
- ai/
|
|
- index.md
|
|
- overview.md
|
|
- ios.md
|
|
- android.md
|
|
- cross-platform.md
|
|
- skills.md
|
|
- usage-tokens.md
|
|
- troubleshooting.md
|
|
- governance.md
|
|
|
|
## Top-Level Hierarchy (Confluence)
|
|
1. AI Overview
|
|
2. iOS (Xcode + optional VS Code)
|
|
3. Android (VS Code)
|
|
4. Cross-Platform AI Usage
|
|
5. Skills Library
|
|
6. Usage and Token Budgeting
|
|
7. Troubleshooting and FAQ
|
|
8. Governance, Privacy, and Policy
|
|
|
|
## 1) AI Overview
|
|
- Start Here
|
|
- What AI is and is not (short definitions)
|
|
- What problems AI can help with (examples)
|
|
- What not to use AI for (guardrails)
|
|
- GitHub Copilot Enterprise
|
|
- What it is
|
|
- Access requirements
|
|
- Account setup steps
|
|
- Terminology
|
|
- Copilot
|
|
- Chat
|
|
- Agents
|
|
- Skills
|
|
- Tokens and usage
|
|
- Getting Help
|
|
- Who to contact
|
|
- Where to report issues
|
|
|
|
## 2) iOS (Xcode + optional VS Code)
|
|
- Setup Path A: Xcode + GitHub Copilot for Xcode
|
|
- Prerequisites
|
|
- Install plugin
|
|
- Sign in and verify
|
|
- First-use walkthrough
|
|
- Setup Path B: VS Code + GitHub Copilot extension
|
|
- When to use VS Code on iOS
|
|
- Install extension
|
|
- Sign in and verify
|
|
- First-use walkthrough
|
|
- iOS-Specific Guidance
|
|
- Swift/SwiftUI tips
|
|
- Common prompt patterns for iOS
|
|
- iOS Troubleshooting
|
|
- Login issues
|
|
- Suggestions not appearing
|
|
- Network or policy blocks
|
|
|
|
## 3) Android (VS Code)
|
|
- Setup: VS Code + GitHub Copilot extension
|
|
- Prerequisites
|
|
- Install extension
|
|
- Sign in and verify
|
|
- First-use walkthrough
|
|
- Android-Specific Guidance
|
|
- Kotlin/Java tips
|
|
- Common prompt patterns for Android
|
|
- Android Troubleshooting
|
|
- Login issues
|
|
- Suggestions not appearing
|
|
- Network or policy blocks
|
|
|
|
## 4) Cross-Platform AI Usage
|
|
- Agents.md
|
|
- What it is
|
|
- How to use it (copy/paste examples)
|
|
- When to use agents vs chat
|
|
- Prompting Patterns
|
|
- Asking for refactors
|
|
- Writing tests
|
|
- Debugging errors
|
|
- Explaining unfamiliar code
|
|
- Connecting Skills
|
|
- When to use a skill
|
|
- How to chain multiple skills
|
|
- How to pass context between steps
|
|
|
|
## 5) Skills Library
|
|
- What skills are
|
|
- How to download existing skills
|
|
- How to enable or configure skills
|
|
- Current Skills (add repo links)
|
|
- onboarding-cro (link)
|
|
- revenuecat-ios-integration (link)
|
|
- find-skills (link)
|
|
- swiftui-expert-skill (link)
|
|
- mcp-builder (link)
|
|
- pdf (link)
|
|
- skill-creator (link)
|
|
- template-skill (link)
|
|
- webapp-testing (link)
|
|
|
|
## 6) Usage and Token Budgeting
|
|
- How tokens are spent (simple model)
|
|
- Best practices to reduce usage
|
|
- Use clear, bounded requests
|
|
- Prefer edits over full rewrites
|
|
- Reuse context instead of re-sending
|
|
- Daily and monthly budgeting tips
|
|
- Red flags that burn tokens quickly
|
|
- Quick checklist
|
|
|
|
## 7) Troubleshooting and FAQ
|
|
- Setup and login errors
|
|
- Extension or plugin conflicts
|
|
- Company network restrictions
|
|
- Why suggestions are low quality
|
|
- When to escalate
|
|
|
|
## 8) Governance, Privacy, and Policy
|
|
- What data is allowed
|
|
- What data is forbidden
|
|
- Safe prompts and examples
|
|
- Compliance and audit expectations
|
|
|
|
## Next Steps
|
|
- Assign owners per section
|
|
- Link skills to their repos
|
|
- Add screenshots and short videos
|
|
- Set review cadence
|