Skip to content

Non-Technical Collaborator Workflow Guide#5

Merged
davida-ps merged 10 commits intomainfrom
auto-claude/005-non-technical-collaborator-workflow-guide
Jan 24, 2026
Merged

Non-Technical Collaborator Workflow Guide#5
davida-ps merged 10 commits intomainfrom
auto-claude/005-non-technical-collaborator-workflow-guide

Conversation

@davida-ps
Copy link
Owner

Create comprehensive documentation for collaborating with co-authors who don't use git or markdown. Include Word export/import workflows, track changes integration, and feedback incorporation strategies.

davida-ps and others added 10 commits January 24, 2026 21:43
…with tab

Created comprehensive structure for COLLABORATION_GUIDE.md with:
- Clear overview explaining purpose and benefits
- Detailed table of contents covering all planned sections
- Section placeholders for Word export/import workflows
- Multi-collaborator management strategies
- Version comparison and tracking workflows
- Platform-specific instructions
- Troubleshooting and best practices sections
- Cross-references to related documentation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
…docx format

- Added comprehensive Word export configuration guide
- Documented quarto render command and output location
- Explained what formatting elements are preserved during export
- Provided 8 practical formatting tips for optimal Word exports
- Created collaborator communication best practices
- Included document preparation and expectation-setting guidelines

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
…changes

- Added comprehensive "Understanding Tracked Changes" section explaining how Word tracks edits
- Documented step-by-step process for accepting/rejecting changes in Word
- Provided three approaches for converting feedback back to markdown (automated, manual, hybrid)
- Included tools comparison table (pandoc, git diff, visual diff tools)
- Documented five manual merge strategies with practical examples
- Added common pitfalls and solutions for each workflow step
- Included command examples for macOS, Windows, and Linux

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
…ement st

Implemented comprehensive section on managing multiple collaborators with:
- Version naming conventions: templates, examples, directory structure
- Feedback consolidation workflow: 10-step process with tracking
- Git branching strategy: sequential, parallel, and experimental workflows
- Handling conflicting feedback: 7 resolution strategies with examples

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
- Added Example 1: PhD Student and Advisor workflow with step-by-step instructions
- Added Example 2: Research Team with Multiple Reviewers including consolidation strategy
- Added Example 3: Handling Conflicting Suggestions with resolution strategies
- Added Quick Reference Commands section with common commands and utilities
- Added comprehensive workflow visualization diagrams
- Populated Troubleshooting section (Section 8) with:
  * Citations Not Rendering in Word
  * Formatting Lost During Export
  * Merge Conflicts
  * Large Files and Performance
- Includes practical solutions, verification steps, and diagnostic tools
Added comprehensive platform-specific sections for macOS, Windows, and Linux covering:
- Microsoft Word compatibility options (native and alternatives)
- Command-line variations and file path conventions
- Platform-specific tips and automation
- Installation instructions for Word alternatives
- Distribution-specific notes for Linux

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Fixed all markdown links in COLLABORATION_GUIDE.md to use repository-root-relative paths
instead of file-relative paths. This ensures links are verifiable from the repository root
and work correctly in all contexts.

Changes:
- Changed ../GETTING_STARTED.md to GETTING_STARTED.md
- Changed ./TROUBLESHOOTING.md to docs/TROUBLESHOOTING.md (2 occurrences)
- Changed ../CUSTOMIZATION_GUIDE.md to CUSTOMIZATION_GUIDE.md

All links verified and working correctly.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
The README was linking to COLLABORATION_GUIDE.md at the repository root,
but the file is actually located at docs/COLLABORATION_GUIDE.md. This
fixes the broken link so users can access the collaboration guide.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@davida-ps davida-ps merged commit f646721 into main Jan 24, 2026
1 check passed
@github-actions
Copy link

🎉 PR Preview Ready!

Your research documents have been successfully rendered and are ready for review.

📦 Available Artifacts (1)

  • 📊 Slidev Presentation (PDF)

📥 Download Instructions

Option 1: Download from GitHub UI

  1. Go to the workflow run
  2. Scroll to the "Artifacts" section at the bottom
  3. Click on the artifact name to download

Option 2: Using GitHub CLI

# Download all artifacts
gh run download 21321303006 --repo davida-ps/research-template

# Download specific artifact
gh run download 21321303006 --repo davida-ps/research-template --name slidev-presentation-pdf
gh run download 21321303006 --repo davida-ps/research-template --name research-paper-pdf
gh run download 21321303006 --repo davida-ps/research-template --name research-paper-html
gh run download 21321303006 --repo davida-ps/research-template --name blog-posts-pdfs

📋 Artifact Details


Generated by PR Preview CI/CD Pipeline

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant