|
| 1 | +--- |
| 2 | +name: Documentation Issue |
| 3 | +about: Report problems with the FastPix Node SDK documentation |
| 4 | +title: '[DOCS] ' |
| 5 | +labels: ['documentation', 'needs-triage'] |
| 6 | +assignees: '' |
| 7 | +--- |
| 8 | + |
| 9 | +# Documentation Issue |
| 10 | + |
| 11 | +Thank you for helping improve the FastPix Node SDK documentation! Please provide the following information: |
| 12 | + |
| 13 | +## Issue Type |
| 14 | +- [ ] Missing documentation |
| 15 | +- [ ] Incorrect information |
| 16 | +- [ ] Unclear explanation |
| 17 | +- [ ] Broken links |
| 18 | +- [ ] Outdated content |
| 19 | +- [ ] Other: _______________ |
| 20 | + |
| 21 | +## Description |
| 22 | +**Clear description of the documentation issue:** |
| 23 | + |
| 24 | +<!-- What's wrong with the documentation? --> |
| 25 | + |
| 26 | +## Current Documentation |
| 27 | +**What does the current documentation say?** |
| 28 | + |
| 29 | +<!-- Paste the current documentation content --> |
| 30 | + |
| 31 | +## Expected Documentation |
| 32 | +**What should the documentation say instead?** |
| 33 | + |
| 34 | +<!-- Describe what the correct documentation should be --> |
| 35 | + |
| 36 | +## Location |
| 37 | +**Where is this documentation issue located?** |
| 38 | + |
| 39 | +- [ ] README.md |
| 40 | +- [ ] docs/ directory |
| 41 | +- [ ] USAGE.md |
| 42 | +- [ ] CONTRIBUTING.md |
| 43 | +- [ ] API documentation |
| 44 | +- [ ] Code examples |
| 45 | +- [ ] Other: _______________ |
| 46 | + |
| 47 | +**Specific file and section:** |
| 48 | +<!-- e.g., README.md line 45, or docs/api-reference.md section "Authentication" --> |
| 49 | + |
| 50 | +## Impact |
| 51 | +**How does this documentation issue affect users?** |
| 52 | + |
| 53 | +- [ ] Blocks new users from getting started |
| 54 | +- [ ] Causes confusion for existing users |
| 55 | +- [ ] Leads to incorrect implementation |
| 56 | +- [ ] Creates support requests |
| 57 | +- [ ] Other: _______________ |
| 58 | + |
| 59 | +## Proposed Fix |
| 60 | +**How would you like this documentation issue to be resolved?** |
| 61 | + |
| 62 | +<!-- Example of how the documentation should be written --> |
| 63 | +# Correct Documentation |
| 64 | + |
| 65 | +Here's how the documentation should be written: |
| 66 | + |
| 67 | +```kotlin |
| 68 | + private val fastPixDataSDK = FastPixDataSDK() |
| 69 | + val videoDataDetails = VideoDataDetails( |
| 70 | + videoId = UUID.randomUUID().toString(), |
| 71 | + videoTitle = "My Video" |
| 72 | + ).apply { |
| 73 | + videoSeries = "Demo Series" |
| 74 | + videoProducer = "Demo Producer" |
| 75 | + videoContentType = "VOD" |
| 76 | + // ..etc |
| 77 | + } |
| 78 | + // Optional |
| 79 | + val playerDataDetails = PlayerDataDetails( |
| 80 | + playerName = "media3", |
| 81 | + playerVersion = "latest-version" |
| 82 | + ) |
| 83 | + // Optional |
| 84 | + val customDataDetails = CustomDataDetails().apply { |
| 85 | + customField1 = "Custom Value 1" |
| 86 | + customField2 = "Custom Value 2" |
| 87 | + // ..etc |
| 88 | + } |
| 89 | + |
| 90 | + fastPixDataSDK = FastPixBaseMedia3Player( |
| 91 | + context = this, |
| 92 | + playerView = binding.playerView, |
| 93 | + exoPlayer = exoPlayer, |
| 94 | + workSpaceId = "workspace-key", |
| 95 | + playerDataDetails = playerDataDetails, |
| 96 | + videoDataDetails = videoDataDetails, |
| 97 | + customDataDetails = customDataDetails |
| 98 | + ) |
| 99 | +``` |
| 100 | + |
| 101 | +## Additional Context |
| 102 | + |
| 103 | +## Screenshots |
| 104 | +<!-- If applicable, include screenshots of the documentation issue --> |
| 105 | + |
| 106 | +### Related Issues |
| 107 | +- **GitHub Issues:** [Link to any related issues] |
| 108 | +- **User Feedback:** [Link to user complaints or confusion] |
| 109 | + |
| 110 | +### Testing |
| 111 | +**How did you discover this issue?** |
| 112 | + |
| 113 | +- [ ] While following the documentation |
| 114 | +- [ ] User reported confusion |
| 115 | +- [ ] Code didn't work as documented |
| 116 | +- [ ] Other: _______________ |
| 117 | + |
| 118 | +## Priority |
| 119 | +Please indicate the priority of this documentation issue: |
| 120 | + |
| 121 | +- [ ] Critical (Blocks users from using the SDK) |
| 122 | +- [ ] High (Causes significant confusion) |
| 123 | +- [ ] Medium (Minor clarity issue) |
| 124 | +- [ ] Low (Cosmetic improvement) |
| 125 | + |
| 126 | +## Checklist |
| 127 | +Before submitting, please ensure: |
| 128 | + |
| 129 | +- [ ] I have identified the specific documentation issue |
| 130 | +- [ ] I have provided the current and expected content |
| 131 | +- [ ] I have explained the impact on users |
| 132 | +- [ ] I have proposed a clear fix |
| 133 | +- [ ] I have checked if this is already reported |
| 134 | +- [ ] I have provided sufficient context |
| 135 | + |
| 136 | +--- |
| 137 | + |
| 138 | +**Thank you for helping improve the FastPix Node SDK documentation! 📚** |
0 commit comments