Collaboration Workflow for LaTeX Projects

# Initialize collaborative LaTeX project
git init latex-project
cd latex-project

# Create standard structure
mkdir -p {chapters,figures,styles,build}
touch .gitignore README.md CONTRIBUTING.md

# .gitignore for LaTeX
cat > .gitignore << 'EOF'
# LaTeX temporary files
*.aux
*.lof
*.log
*.lot
*.fls
*.out
*.toc
*.fmt
*.fot
*.cb
*.cb2
.*.lb

# Bibliography
*.bbl
*.bcf
*.blg
*-blx.aux
*-blx.bib
*.run.xml

# Build artifacts
build/
*.pdf
!figures/*.pdf
!templates/*.pdf

# Editors
.vscode/
*.swp
*~
.DS_Store

# LaTeX editors
*.synctex.gz
*.synctex.gz(busy)
*.pdfsync
EOF

# Initial commit
git add .
git commit -m "Initial project structure"

# Collaborative LaTeX Project

## Project Structure

# Multiple authors working simultaneously

# Author A: Introduction
git checkout -b feature/introduction
# Edit chapters/introduction.tex
git add chapters/introduction.tex
git commit -m "feat(intro): Add research background"

# Author B: Results  
git checkout -b feature/results
# Edit chapters/results.tex
git add chapters/results.tex figures/results/*
git commit -m "feat(results): Add experimental data"

# Integration manager
git checkout develop
git merge feature/introduction
git merge feature/results
# Resolve any conflicts
make  # Test build
git push origin develop

% Common conflict scenario
<<<<<<< HEAD
\section{Results}
Our experimental results show a 95\% accuracy rate.
=======
\section{Experimental Results}
The experiments demonstrate 94.8\% accuracy.
>>>>>>> feature/results

% Resolution approach
\section{Experimental Results}
Our experimental results show a 94.8\% accuracy rate.

% Best practices:
% 1. Communicate about sections
% 2. Use semantic line breaks
% 3. One sentence per line
% 4. Regular integration

% Bad: Hard to merge
\section{Introduction}
This research investigates machine learning applications in healthcare. We propose a novel approach that combines deep learning with traditional statistical methods. Our results show significant improvements.

% Good: Easy to merge
\section{Introduction}
This research investigates machine learning applications in healthcare.
We propose a novel approach that combines deep learning with traditional statistical methods.
Our results show significant improvements.

% Each sentence on its own line
% Easier diffs and merges
% Clear change history

# .github/pull_request_template.md
## LaTeX Document Review Checklist

### Content Review
- [ ] Content is accurate and complete
- [ ] All sections are properly structured
- [ ] References are correctly cited
- [ ] Figures and tables are referenced

### Technical Review  
- [ ] Document compiles without errors
- [ ] No undefined references
- [ ] No overfull/underfull boxes
- [ ] Images are optimized

### Style Review
- [ ] Consistent formatting throughout
- [ ] Proper use of environments
- [ ] Correct math notation
- [ ] Clear and concise writing

### Bibliography
- [ ] All citations have entries
- [ ] BibTeX entries are complete
- [ ] Citation style is consistent

### Final Checks
- [ ] Spell check completed
- [ ] Grammar check completed
- [ ] PDF output looks correct
- [ ] Version number updated

# .github/workflows/latex-build.yml
name: Build LaTeX document

on:
  pull_request:
    branches: [ main ]
  push:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v2
    
    - name: Compile LaTeX
      uses: xu-cheng/latex-action@v2
      with:
        root_file: main.tex
        
    - name: Check for errors
      run: |
        ! grep -E "(Warning|Error|Undefined)" main.log
        
    - name: Upload PDF
      uses: actions/upload-artifact@v2
      with:
        name: document
        path: main.pdf

# Contributing Guidelines

## Communication Channels
- **Slack**: #latex-project for daily communication
- **GitHub Issues**: Bug reports and feature requests
- **Weekly Meetings**: Thursdays 2 PM UTC

## Writing Style Guide
1. **Voice**: Active voice preferred
2. **Tense**: Present tense for methods
3. **Terminology**: See glossary.tex
4. **Citations**: Author-year format

## LaTeX Conventions
### File Naming
- Chapters: `ch01-introduction.tex`
- Figures: `fig-chapter-description.pdf`
- Tables: `tab-chapter-description.tex`

### Labels
- Sections: `sec:chapter:section`
- Figures: `fig:chapter:name`
- Tables: `tab:chapter:name`
- Equations: `eq:chapter:name`

### Code Style
```latex
% Good
\begin{figure}[htbp]
    \centering
    \includegraphics[width=0.8\textwidth]{figure}
    \caption{Clear description}
    \label{fig:chapter:example}
\end{figure}

% Bad
\begin{figure}[h]
\includegraphics{figure}
\caption{Fig}
\end{figure}

# LaTeX Project Meeting - [Date]

## Attendees
- [ ] Alice (Lead Author)
- [ ] Bob (Methods)
- [ ] Carol (Analysis)
- [ ] Dave (Review)

## Agenda
1. Progress updates (10 min)
2. Blockers and issues (10 min)
3. Review assignments (15 min)
4. Next steps (10 min)

## Progress Updates
### Alice
- Completed introduction revision
- TODO: Address Bob's comments

### Bob
- Methodology section 80% complete
- Blocked: Need data from Carol

## Action Items
| Task | Owner | Due Date |
|------|-------|----------|
| Revise introduction | Alice | Friday |
| Provide data tables | Carol | Wednesday |
| Review methodology | Dave | Next Monday |

## Next Meeting
Date: [Next week same time]
Focus: Results section review

#!/bin/bash
# Complete collaboration setup

# 1. Initialize repository
git init latex-collaborative-paper
cd latex-collaborative-paper

# 2. Create structure
mkdir -p {chapters,figures,reviews,builds}
mkdir -p .github/workflows

# 3. Setup Git hooks
cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
# Check for LaTeX errors before commit
make check
EOF
chmod +x .git/hooks/pre-commit

# 4. Create main document
cat > main.tex << 'EOF'
\documentclass[12pt]{article}
\usepackage{changes}
\usepackage{todonotes}

% Define authors
\definechangesauthor[name={Alice}, color=blue]{AA}
\definechangesauthor[name={Bob}, color=red]{BB}

\title{Collaborative Research Paper}
\author{Alice \and Bob}

\begin{document}
\maketitle

\input{chapters/introduction}
\input{chapters/methods}
\input{chapters/results}
\input{chapters/conclusion}

\bibliographystyle{plain}
\bibliography{references}

\end{document}
EOF

# 5. Create Makefile
cat > Makefile << 'EOF'
.PHONY: all clean check watch

all: main.pdf

main.pdf: main.tex chapters/*.tex
	pdflatex main
	bibtex main
	pdflatex main
	pdflatex main

check:
	@echo "Checking for errors..."
	@! grep -i "error\|warning\|undefined" main.log

clean:
	rm -f *.aux *.log *.out *.toc *.bbl *.blg

watch:
	latexmk -pvc -pdf main.tex
EOF

# 6. Setup CI/CD
cat > .github/workflows/build.yml << 'EOF'
name: Build and Check
on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v2
    - uses: xu-cheng/latex-action@v2
      with:
        root_file: main.tex
    - uses: actions/upload-artifact@v2
      with:
        name: PDF
        path: main.pdf
EOF

echo "Collaboration environment ready!"