I'm writing a paper, and I've found a decent approach to keep things organized:

1) Everything is in a repo, and i collaborate with the other authors through (private repo, for now).
Changes to the text are discussed through github issues and PR.

2) To overcome writer's block I wrote a one line comment where each paragraph will be, so that I get an idea of the logic of the paper.
The paragraphs then are folded (using ) into the one line summaries, to keep the overview.

Sounds really good. I've been looking for a solution to #2 every now and then, i.e. how to toggle between viewing the full text and an outline without maintaining separate files.

Come to think of it, maybe occur mode could do this with some kind of markers for the outline elements (I'm using emacs)

@mmin @mprv This workflow sounds awesome :-) I wish my co-authors would jump over the git hurdle.

Re outlining: Many text-editors should have some kind of folding tools. Maybe via a plugin for the most common file formats, for example github.com/SublimeText-Markdow

@gittaca @mmin

Thank you, I've been very lucky with my two current collaborators, and I"m trying to convince as many people as I can to use git. Luckily there are now many easy interfaces towards it (the atom integration is very user friendly, for example) so that even people who do not feel comfortable with the command line can get started.

I usually use vim with "foldmethod = marker", but I couldn't find an equally powerful substitute for Atom. Do you know of any?

image/svg+xml Follow

@gittaca @mmin

This is close atom.io/packages/custom-folds, but it doesn't play nice with vim-mode-plus for some reason (maybe I haven't configured it right) and having to start every comment with the same marker rather than ending it feels inelegant.

Vim's structure looks much better, in my opinion:

# Something something {{{
code to be folded
# }}}

Sign in to participate in the conversation
Scholar Social

Scholar Social is a microblogging platform for researchers, grad students, librarians, archivists, undergrads, academically inclined high schoolers, educators of all levels, journal editors, research assistants, professors, administrators—anyone involved in academia who is willing to engage with others respectfully. Read more ...