Academic writing workflow

Cranking the paper mill in the 21st century


“Documenting my academic writing workflow and how to improve it”, or, “How I learned to stop worrying and love text files”.

Science blog

Now under academic blogging workflow.

Writing papers

Writing papers, especially collaboratively, is a a constant pain point. You might want to try a scientific notebook such as jupyter, knitr etc, which will generate the requisite diagrams etc. rticles , in particular, takes the scientific computation tools and turns them to generating photo-ready journal submissions.

Guides

Minimally painful LaTeX collaboration

And you need to work with collaborators of different technical expertise levels, across various quirky LaTeX setups, here are some options.

  • teletype enables generic live collaborative document editing (atom. No special support for latex.)

  • Overleaf (formerly ShareLaTeX) is an open source online collaborative LaTeX editor. They also have a hosted version.

    • Work together on a single version
    • View collaborator edits
    • No complicated LaTeX installation
    • Restore to any older version
    • Access your work from anywhere in the world
    • Work offline and sync your files via Dropbox and GitHub
  • papernow is more radical (and more ugly) again.

    Create, edit and (optionally) display a journal article, entirely in GitHub.

    In contrast to the more traditional process of submit > peer review > publish at PeerJ, or even the less formal preprints at PeerJ Preprints or arXiv, Paper Now is an experiment to see where the future may go with scholarly communication. Initially, it may be that co-authors collaborate either privately or publicly on GitHub and then proceed to submitting to PeerJ or other journals for formal peer-review or preprinting. Or perhaps this is where the traditional medium of publication begins to diverge. There is no end goal other than to see what the academic community wants, which is why this is completely open to fork, extend, and build upon.

Emailing word files between collaborators

You have passed beyond my ability to help you.