12 votes

Best Tool to Create User Guides

For internal documentation I've found wikis to be quite useful. A wiki has several useful features for this task: built-in change-tracking doc can be structured as several pages (e.g. one per major ...
user avatar
7 votes

How should a writer use version control to track drafts, rewrites, and revisions?

Just to play devil's advocate a little bit, I think a case can definitely be made for not using a software version control tool in writing. As a writer who also works in the software development ...
user avatar
  • 1,551
6 votes

What software can I use to synchronize corrections and modifications over similar documents?

WinMerge can help you manually merge documents. It can compare two text documents, highlight similar lines and lines that are slightly different and it allows you to quickly choose which version to ...
user avatar
  • 61
5 votes

Linking documentation to Git commit comments

Identifying a commit A universal identifier for each commit is its SHA1 — a 40 digit hexadecimal number, like this one: 3e0b5fb09d70d0457d7e5ae7892504f6e1b45f33 This commit is from the Sphinx ...
user avatar
4 votes

What software can I use to synchronize corrections and modifications over similar documents?

Lyx have some subdocuments abilities that may help. But you'll have to port your work in this new environment and it may not suits your other needs. Nevertheless, it is one of my favorite writing ...
user avatar
4 votes

What software can I use to synchronize corrections and modifications over similar documents?

You might consider using R-Markdown. I can imagine a process where you: Convert all of your current documents to separate markdowns in plain markdown text Identify the components you wish to keep ...
user avatar
4 votes
Accepted

What websites or programs offer strong revision tools?

You are talking about a Revision Control System, and it's a principle tool among software engineers. Using git (not github, but git on your own files) is a great idea. The thorn is that you don’t ...
user avatar
  • 525
3 votes

What websites or programs offer strong revision tools?

Google docs has insane levels of versioning, and can compare changes since any specified version, showing additions and deletions. It's probably your best choice. Scrivener, probably the most widely ...
user avatar
  • 964
3 votes
Accepted

Linking documentation to Git commit comments

I'm not sure I can provide a full solution to this, as the workflow seems to have so many variables. If what you are after is just getting the comment without copying or pasting, you can use something ...
user avatar
3 votes

How should a writer use version control to track drafts, rewrites, and revisions?

I do not know whether the sophisticated functionality of git would be all that useful, unless perhaps if you are collaborating with another writer. However git does offer a couple of things that are ...
user avatar
  • 131
2 votes

Do You Use Any Version Controlling Software/Methods As Writers?

If you are using a Mac, one thing that many people miss is that there is built-in system versioning that is available in any app that supports it. For example, if you are writing in Pages, you can go ...
user avatar
  • 1,348
2 votes

Do You Use Any Version Controlling Software/Methods As Writers?

I use The Novel Factory (as you might expect) which allows me to have tabs for up to three drafts, plus 'blocking'. I also occasionally save a new version of my entire novel file in case I want to go ...
user avatar
2 votes

Do You Use Any Version Controlling Software/Methods As Writers?

As I'm a programmer I do, as I'm used to it and version control is made for tracking revisions of text, so it is working pretty good with writings. Pros using version control: backup is easier, as I ...
user avatar
  • 2,042
2 votes

Best Tool to Create User Guides

In the past, I've used a wiki for this type of work. However, a tool doesn't organize itself. The best wiki sites are heavily edited from every level from copy to development.
user avatar
  • 249
2 votes

Hosting my writing on Github - public or private repository?

If you want to share your work while you write it, github is an okay way to do that. It's not great, because it's usable only by the tiny fraction of people who know how to use git. Consider LeanPub....
user avatar
2 votes

Scrivener 3 on older MacBook

Not to sound rude, but you mostly answered it in your own question. You have a lesser version than the requirement. Sometimes this means the application will not run at all, other times it means it ...
user avatar
  • 4,561
2 votes

Git plugins for MS Word?

Use pandoc to convert word documents to markdown so they can be tracked in git. Here is a blog post that explains this using microsoft word with git. Consider also Latex based alternatives such as : ...
user avatar
1 vote

Git plugins for MS Word?

I would recommend to just use any of the Git GUI clients rather than a plugin for Word. I'd recommend GitKraken. A note, I do use GIT for software development with tools that do support git natively (...
user avatar
1 vote

Linking documentation to Git commit comments

I saw a post on exactly this idea on WtD slack channel a few days back - I want to say the approach was called typson+docson, and was directly pulling comments into a documentation system off the bat -...
user avatar
1 vote

Hosting my writing on Github - public or private repository?

I keep my fanfiction on Github. https://github.com/IWriteThings/fanfiction.fmpgcol I have since moved all of my original writing over to a Gitlab self hosted server that I have through a company ...
user avatar
1 vote

For a single author writing short stories in LaTeX, is it worthwhile to switch to a "real" version control system from Dropbox?

If you're anticipating large structural changes to your LaTeX documents, then a version control system might do you some good. If that's the case, use git since you're familiar with it. Mercurial (hg) ...
user avatar
  • 631
1 vote

How to create a useful diff of a markdown writing project iteration

I'm not sure about using Git commit. I don't use it much. How about tokenizing your text in Python? Then calculate the entropy per sentence. This would show difference between sentences. ...
user avatar
1 vote

How to create a useful diff of a markdown writing project iteration

I presume you have already tried the flags --minimal and --ignore-all-space. If line breaks due to added/deleted/changed words are causing the problem with diff (making it look like changes appeared ...
user avatar
  • 92.1k
1 vote

Scrivener 3 on older MacBook

To follow what other people have said, it should work considering 10.11.2 is newer than 10.2. 13 years newer, actually. See the releases section here. I use Scrivener on Windows and highly recommend ...
user avatar
  • 2,222
1 vote

Scrivener 3 on older MacBook

Likely worth verifying with the Scrivener publishers and/or Apple, but in most software version numbering systems, 10.11.* is newer than 10.2.*. That would mean Mac Scrivener will work as well on ...
user avatar
  • 4,616
1 vote

Managing Document Versions for Multiple Tenses

With some tools, you can tag the two verb forms as conditional text in the source document and then render the version you want in the output. If you're writing a status report, I recommend using ...
user avatar
  • 1,873
1 vote

Hosting my writing on Github - public or private repository?

Have a look at medium.com it is built for writers it has revisions and notations.
user avatar
  • 131
1 vote

Does using version control system make backups unnecessary?

If you're backing up your git repo by simply using remote repositories, then no, you don't need further backups. When you make a commit, you're making a backup copy and putting it in the .git ...
user avatar
  • 111
1 vote

What's the best version control system for a book writer?

If you are using mac, you can try Drawers, which is specially designed for writers, use it to manage versions and copies of works. This way you don’t have to keep duplicating and renaming your files. ...
user avatar

Only top scored, non community-wiki answers of a minimum length are eligible