@riotprompt/riotdoc 1.0.1-dev.0 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,497 @@
1
+ # Research Paper Document Template
2
+
3
+ ## Template Structure
4
+
5
+ This defines the structure and questions for creating research paper documents in RiotDoc.
6
+
7
+ **Template Type**: research-paper
8
+ **Version**: 2.0
9
+ **Last Updated**: 2026-01-30
10
+
11
+ ---
12
+
13
+ ## Questions to Answer
14
+
15
+ ### Idea/Draft Phase
16
+
17
+ These are the questions you can answer **NOW** when starting your research paper. Focus on the core research question and approach.
18
+
19
+ #### Core Research
20
+ - **Research question**: What are you investigating?
21
+ - **Hypothesis**: What do you expect to find? (if applicable)
22
+ - **Field/discipline**: What area of study?
23
+ - **Significance**: Why does this research matter?
24
+
25
+ #### Background & Context
26
+ - **Literature review**: What existing research is relevant?
27
+ - **Research gap**: What's missing in current knowledge?
28
+ - **Theoretical framework**: What theories or models are you using?
29
+
30
+ #### Methodology
31
+ - **Research design**: Qualitative, quantitative, mixed methods?
32
+ - **Data collection**: How will you gather data?
33
+ - **Analysis approach**: How will you analyze the data?
34
+ - **Limitations**: What are the constraints or boundaries?
35
+
36
+ #### Scope
37
+ - **Target audience**: Academic peers, practitioners, general public?
38
+ - **Length**: Short paper (3-5k words), standard (6-8k), extended (10k+)?
39
+
40
+ ---
41
+
42
+ ### Publishing Phase
43
+
44
+ These are questions you figure out **LATER** - when preparing for submission and publication.
45
+
46
+ #### Publication Details
47
+ - **Target journal/venue**: Where will this be published?
48
+ - **Citation style**: APA, MLA, Chicago, IEEE, etc.?
49
+ - **Formatting requirements**: Does venue have specific formatting rules?
50
+ - **Sections required**: Does venue require specific sections or structure?
51
+ - **Word/page limits**: Specific length constraints?
52
+
53
+ #### Citations & References
54
+ - **Reference management**: How are you managing citations? (Zotero, EndNote, Mendeley)
55
+ - **Citation completeness**: All sources properly cited?
56
+ - **Reference list**: Formatted correctly per style guide?
57
+
58
+ #### Supplementary Materials
59
+ - **Figures and tables**: All properly labeled and referenced?
60
+ - **Appendices**: What supplementary material to include?
61
+ - **Data availability**: Will you share data? Where?
62
+ - **Code/materials**: Any code or materials to share?
63
+
64
+ #### Submission
65
+ - **Co-authors**: Who are the co-authors? Order?
66
+ - **Acknowledgments**: Who to thank? Funding sources?
67
+ - **Conflicts of interest**: Any conflicts to disclose?
68
+ - **Ethics approval**: IRB or ethics board approval needed?
69
+ - **Keywords**: What keywords for indexing?
70
+
71
+ ---
72
+
73
+ ## Available Approaches
74
+
75
+ Choose the approach that best fits your research scope and publication goals.
76
+
77
+ ### Approach 1: Short Paper
78
+
79
+ **When to use**:
80
+ - Conference paper or workshop submission
81
+ - Preliminary findings or work-in-progress
82
+ - Limited scope or focused question
83
+ - Short page limit (4-8 pages)
84
+ - Quick turnaround needed
85
+
86
+ **Strategy**:
87
+ - Focus on one key finding or contribution
88
+ - Concise literature review (1-2 pages)
89
+ - Streamlined methodology section
90
+ - Clear but brief results and discussion
91
+ - Minimal appendices
92
+
93
+ **Output**: Short research paper, 3,000-5,000 words
94
+
95
+ **Workflow**:
96
+ 1. Answer core Idea/Draft questions
97
+ 2. Conduct focused literature review
98
+ 3. Design and execute research
99
+ 4. Analyze data
100
+ 5. Create outline with required sections
101
+ 6. Draft each section concisely
102
+ 7. Create figures/tables (limit to 2-4)
103
+ 8. Write abstract (150 words)
104
+ 9. Answer Publishing phase questions
105
+ 10. Format per venue requirements
106
+ 11. Get co-author feedback
107
+ 12. Revise and polish
108
+ 13. Submit
109
+
110
+ **Timeline**: 1-3 months from research to submission
111
+
112
+ ---
113
+
114
+ ### Approach 2: Standard Paper
115
+
116
+ **When to use**:
117
+ - Journal article submission
118
+ - Complete research study
119
+ - Standard academic contribution
120
+ - Typical page limit (8-15 pages)
121
+ - Thorough treatment of topic
122
+
123
+ **Strategy**:
124
+ - Comprehensive literature review
125
+ - Detailed methodology section
126
+ - Full presentation of results
127
+ - In-depth discussion and implications
128
+ - Proper appendices for supplementary material
129
+
130
+ **Output**: Standard research paper, 6,000-8,000 words
131
+
132
+ **Workflow**:
133
+ 1. Answer all Idea/Draft phase questions
134
+ 2. Conduct comprehensive literature review
135
+ 3. Design research methodology
136
+ 4. Collect and analyze data
137
+ 5. Create detailed outline
138
+ 6. Draft introduction and literature review
139
+ 7. Draft methodology section
140
+ 8. Draft results section with figures/tables
141
+ 9. Draft discussion section
142
+ 10. Draft conclusion
143
+ 11. Write abstract (200-250 words)
144
+ 12. Answer all Publishing phase questions
145
+ 13. Format references and citations
146
+ 14. Create all figures and tables
147
+ 15. Write appendices if needed
148
+ 16. Get co-author feedback
149
+ 17. Revise thoroughly (2-3 rounds)
150
+ 18. Proofread carefully
151
+ 19. Submit
152
+
153
+ **Timeline**: 3-6 months from research to submission
154
+
155
+ ---
156
+
157
+ ### Approach 3: Extended Paper with Appendices
158
+
159
+ **When to use**:
160
+ - Dissertation chapter or thesis
161
+ - Extensive research study
162
+ - Multiple research questions or studies
163
+ - Long form publication (15+ pages)
164
+ - Requires substantial supplementary material
165
+
166
+ **Strategy**:
167
+ - Extensive literature review (multiple sections)
168
+ - Detailed methodology with justification
169
+ - Multiple studies or experiments
170
+ - Comprehensive results with multiple analyses
171
+ - Thorough discussion of implications
172
+ - Substantial appendices with additional data
173
+
174
+ **Output**: Extended research paper, 10,000+ words with appendices
175
+
176
+ **Workflow**:
177
+ 1. Answer all Idea/Draft phase questions
178
+ 2. Conduct extensive literature review (may be ongoing)
179
+ 3. Design comprehensive research methodology
180
+ 4. Collect data (may be multiple studies)
181
+ 5. Analyze data with multiple approaches
182
+ 6. Create detailed outline with all sections
183
+ 7. Draft introduction (2-3 pages)
184
+ 8. Draft literature review (5-10 pages)
185
+ 9. Draft methodology (3-5 pages)
186
+ 10. Draft results for each study/analysis
187
+ 11. Draft discussion (4-6 pages)
188
+ 12. Draft conclusion (2-3 pages)
189
+ 13. Write comprehensive abstract (250 words)
190
+ 14. Answer all Publishing phase questions
191
+ 15. Create all figures, tables, and visualizations
192
+ 16. Write appendices (data, instruments, additional analyses)
193
+ 17. Format all references and citations
194
+ 18. Get co-author feedback
195
+ 19. Revise extensively (3-5 rounds)
196
+ 20. Professional editing if needed
197
+ 21. Final proofread
198
+ 22. Submit
199
+
200
+ **Timeline**: 6-12 months from research to submission
201
+
202
+ ---
203
+
204
+ ## Output Document Structure
205
+
206
+ ```markdown
207
+ # [Paper Title]
208
+
209
+ **Author(s)**: [Names and affiliations]
210
+ **Date**: [Date]
211
+ **Keywords**: [keyword1, keyword2, keyword3, keyword4, keyword5]
212
+
213
+ ---
214
+
215
+ ## Abstract
216
+
217
+ [150-250 word summary covering:
218
+ - Research question/objective
219
+ - Methodology
220
+ - Key findings
221
+ - Main conclusions
222
+ - Implications]
223
+
224
+ ---
225
+
226
+ ## 1. Introduction
227
+
228
+ ### 1.1 Background
229
+ [Context and background information that sets up the research question]
230
+
231
+ ### 1.2 Research Question
232
+ [Clear statement of what you're investigating]
233
+ [Specific research questions or hypotheses]
234
+
235
+ ### 1.3 Significance
236
+ [Why this research matters]
237
+ [Theoretical and practical contributions]
238
+
239
+ ### 1.4 Paper Structure
240
+ [Brief overview of how the paper is organized]
241
+
242
+ ---
243
+
244
+ ## 2. Literature Review
245
+
246
+ ### 2.1 [Topic Area 1]
247
+ [Review of relevant literature on first major theme]
248
+ [Key theories, findings, debates]
249
+
250
+ ### 2.2 [Topic Area 2]
251
+ [Review of relevant literature on second major theme]
252
+
253
+ ### 2.3 [Topic Area 3]
254
+ [Additional topic areas as needed]
255
+
256
+ ### 2.4 Research Gap
257
+ [What's missing in current knowledge]
258
+ [How this paper addresses the gap]
259
+
260
+ ---
261
+
262
+ ## 3. Theoretical Framework (if applicable)
263
+
264
+ ### 3.1 [Theory/Model Name]
265
+ [Description of theoretical framework]
266
+ [How it applies to this research]
267
+
268
+ ---
269
+
270
+ ## 4. Methodology
271
+
272
+ ### 4.1 Research Design
273
+ [Overall approach: qualitative, quantitative, mixed methods]
274
+ [Justification for chosen approach]
275
+
276
+ ### 4.2 Data Collection
277
+ [Participants/sample]
278
+ [Instruments or tools used]
279
+ [Procedures followed]
280
+
281
+ ### 4.3 Data Analysis
282
+ [Analysis methods used]
283
+ [Software or tools]
284
+ [Steps in analysis process]
285
+
286
+ ### 4.4 Validity and Reliability
287
+ [How validity/reliability was ensured]
288
+
289
+ ### 4.5 Ethical Considerations
290
+ [IRB approval, informed consent, etc.]
291
+
292
+ ### 4.6 Limitations
293
+ [Acknowledged constraints and boundaries]
294
+
295
+ ---
296
+
297
+ ## 5. Results
298
+
299
+ ### 5.1 [Finding 1]
300
+ [Presentation of first major finding]
301
+ [Tables, figures, or data visualization]
302
+
303
+ ### 5.2 [Finding 2]
304
+ [Presentation of second major finding]
305
+
306
+ ### 5.3 [Additional Findings]
307
+ [Other significant results]
308
+
309
+ ---
310
+
311
+ ## 6. Discussion
312
+
313
+ ### 6.1 Interpretation of Findings
314
+ [What the results mean]
315
+ [How they answer the research question]
316
+
317
+ ### 6.2 Theoretical Implications
318
+ [How findings contribute to theory]
319
+
320
+ ### 6.3 Practical Implications
321
+ [Real-world applications or recommendations]
322
+
323
+ ### 6.4 Comparison with Prior Research
324
+ [How findings relate to existing literature]
325
+ [Confirmations, contradictions, extensions]
326
+
327
+ ### 6.5 Limitations and Constraints
328
+ [Discussion of study limitations]
329
+ [How they affect interpretation]
330
+
331
+ ---
332
+
333
+ ## 7. Conclusion
334
+
335
+ ### 7.1 Summary
336
+ [Brief recap of research question, methods, and findings]
337
+
338
+ ### 7.2 Contributions
339
+ [What this adds to the field]
340
+ [Key takeaways]
341
+
342
+ ### 7.3 Future Research
343
+ [Questions for further investigation]
344
+ [Directions for future work]
345
+
346
+ ---
347
+
348
+ ## References
349
+
350
+ [All citations in specified format - APA, MLA, Chicago, IEEE, etc.]
351
+
352
+ [Author, A. A. (Year). Title of work. Publisher.]
353
+ [Author, B. B., & Author, C. C. (Year). Title of article. Journal Name, Volume(Issue), pages.]
354
+
355
+ ---
356
+
357
+ ## Appendices
358
+
359
+ ### Appendix A: [Title]
360
+ [Supplementary material - survey instruments, interview protocols, additional data, etc.]
361
+
362
+ ### Appendix B: [Title]
363
+ [Additional supplementary material]
364
+ ```
365
+
366
+ ---
367
+
368
+ ## Example Use Cases
369
+
370
+ ### Academic Research
371
+ - Journal articles
372
+ - Conference papers
373
+ - Dissertation chapters
374
+ - Thesis papers
375
+
376
+ ### Applied Research
377
+ - White papers
378
+ - Technical reports
379
+ - Policy briefs
380
+ - Industry research
381
+
382
+ ### Review Papers
383
+ - Literature reviews
384
+ - Systematic reviews
385
+ - Meta-analyses
386
+
387
+ ---
388
+
389
+ ## Research Paper Writing Tips
390
+
391
+ ### For Short Papers
392
+ - Focus on one clear contribution
393
+ - Be selective with literature review
394
+ - Keep methodology concise but complete
395
+ - Prioritize most important findings
396
+ - Every word counts - be concise
397
+
398
+ ### For Standard Papers
399
+ - Balance breadth and depth
400
+ - Thorough but focused literature review
401
+ - Detailed methodology for replication
402
+ - Present results clearly with visuals
403
+ - Discuss implications thoroughly
404
+
405
+ ### For Extended Papers
406
+ - Organize with clear structure
407
+ - Comprehensive literature review
408
+ - Multiple studies or analyses
409
+ - Extensive discussion of implications
410
+ - Use appendices for supplementary material
411
+
412
+ ---
413
+
414
+ ## Common Pitfalls to Avoid
415
+
416
+ ❌ **Don't**: Start writing before defining research question
417
+ ✅ **Do**: Clarify research question before anything else
418
+
419
+ ❌ **Don't**: Ignore existing literature
420
+ ✅ **Do**: Conduct thorough literature review first
421
+
422
+ ❌ **Don't**: Use methodology that doesn't match question
423
+ ✅ **Do**: Choose methods appropriate for your question
424
+
425
+ ❌ **Don't**: Present results without interpretation
426
+ ✅ **Do**: Discuss what results mean and why they matter
427
+
428
+ ❌ **Don't**: Overclaim or overstate findings
429
+ ✅ **Do**: Be honest about limitations and scope
430
+
431
+ ❌ **Don't**: Wait until last minute to format references
432
+ ✅ **Do**: Use reference manager from the start
433
+
434
+ ---
435
+
436
+ ## Academic Writing Guidelines
437
+
438
+ ### Structure
439
+ - Follow IMRAD structure (Introduction, Methods, Results, And Discussion)
440
+ - Use clear section headings
441
+ - Maintain logical flow between sections
442
+ - Use transitions between paragraphs
443
+
444
+ ### Style
445
+ - Write in third person (usually)
446
+ - Use past tense for what you did
447
+ - Use present tense for general truths
448
+ - Be precise and specific
449
+ - Avoid jargon when possible
450
+
451
+ ### Citations
452
+ - Cite all sources appropriately
453
+ - Use consistent citation style
454
+ - Don't over-cite or under-cite
455
+ - Include page numbers for direct quotes
456
+ - Use reference management software
457
+
458
+ ### Figures and Tables
459
+ - Number all figures and tables
460
+ - Include descriptive captions
461
+ - Reference in text before they appear
462
+ - Keep visuals clear and readable
463
+ - Follow venue formatting guidelines
464
+
465
+ ---
466
+
467
+ ## Template Notes
468
+
469
+ **Version 2.0 Changes** (2026-01-30):
470
+ - Split questions into Idea/Draft and Publishing phases
471
+ - Added three approaches: Short Paper, Standard Paper, Extended Paper
472
+ - Enhanced methodology and discussion sections
473
+ - Added academic writing guidelines
474
+ - Follows canonical template structure from TEMPLATE-STRUCTURE.md
475
+
476
+ **When to use this template**:
477
+ - Academic research papers
478
+ - Conference submissions
479
+ - Journal articles
480
+ - Thesis/dissertation chapters
481
+ - Technical reports
482
+ - White papers
483
+
484
+ ---
485
+
486
+ ## Related Templates
487
+
488
+ - **Blog Post Template**: For research blog posts or summaries
489
+ - **Project Plan Template**: For research project planning
490
+ - **Meeting Notes Template**: For research team meetings
491
+
492
+ ---
493
+
494
+ ## Version History
495
+
496
+ - **v2.0** (2026-01-30): Added lifecycle phases and approaches
497
+ - **v1.0** (2026-01-XX): Initial template (no phase split)
@@ -1,2 +0,0 @@
1
-
2
- //# sourceMappingURL=__vite-browser-external-l0sNRNKZ.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"__vite-browser-external-l0sNRNKZ.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}