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"

% 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

% Project structure for cloud collaboration
% main.tex
\documentclass{article}

% Enable collaboration features
\usepackage{changes}  % Track changes
\usepackage{todonotes} % Comments and todos

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

\begin{document}

\title{Collaborative Research Paper}
\author{Alice A. \and Bob B. \and Carol C.}
\maketitle

% Include sections maintained by different authors
\input{sections/introduction}    % Alice
\input{sections/methodology}     % Bob
\input{sections/results}        % Carol
\input{sections/conclusion}     % All

\end{document}

\documentclass{article}
\usepackage{changes}

% Setup authors
\definechangesauthor[name={John}, color=blue]{JD}
\definechangesauthor[name={Jane}, color=red]{JS}

% Configure display
\setaddedmarkup{\textcolor{#1}{\uline{#2}}}
\setdeletedmarkup{\textcolor{#1}{\sout{#2}}}

\begin{document}

\section{Introduction}

% Track additions
\added[id=JD]{This new section provides important context.}

% Track deletions
\deleted[id=JS]{Remove this outdated information.}

% Track replacements
\replaced[id=JD]{modern approach}{old method}

% Comments
\comment[id=JS]{Need citation here}

% Highlight text
\highlight{Important finding that needs review}

\end{document}

% Simple revision tracking with colors
\usepackage{xcolor}
\usepackage{soul}

% Define revision commands
\newcommand{\rev}[1]{\textcolor{blue}{#1}}
\newcommand{\del}[1]{\textcolor{red}{\sout{#1}}}
\newcommand{\note}[1]{\marginpar{\textcolor{orange}{\footnotesize #1}}}

% Usage
\rev{This text was added in revision 2.}
\del{This text should be removed.}
\note{Check this reference}

% Version-specific content
\newif\ifdraft
\drafttrue  % or \draftfalse

\ifdraft
  \newcommand{\draftonly}[1]{#1}
\else
  \newcommand{\draftonly}[1]{}
\fi

\usepackage[colorinlistoftodos]{todonotes}

% Configure todo notes
\setuptodonotes{
    inline,
    color=yellow!40,
    size=\footnotesize
}

% Different comment types
\newcommand{\alice}[1]{\todo[color=blue!40, inline]{Alice: #1}}
\newcommand{\bob}[1]{\todo[color=red!40, inline]{Bob: #1}}
\newcommand{\review}[1]{\todo[color=green!40, inline]{Review: #1}}

% Usage in document
\section{Results}
Our findings indicate significant improvement.
\alice{Need to add specific percentages here}

The control group showed no change.
\bob{Should we include the p-value?}

\review{This section needs more detail about methodology}

% List all todos
\listoftodos[Notes for revision]

# .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

# 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!"