HN Explorer

How do you deal with changing document versions?

9 points by rashidujang ↗ HN
At my company, the functional specification documents of the system is kept in a server where new additions to said documentation would result in a new version of the document being uploaded with a 1.x version being incrementally added to the file name. This results in a messy folder structure and redundancy.

However, most of the people who need the documentation aren't developers nor necessarily even that tech-savvy.

What are some ways similar problems are combated in your own workplaces?

9 comments

[ 3.9 ms ] story [ 28.9 ms ] thread
dirktheman
I guess you could find some way to convert Word documents to Markdown and keep version control using Git, but for non-tech-savvy users I assume that's going to be a problem...
[dead] whatsstolat
Its OK to put word docs themselves in git, and then use word itself as your compare tool. We do this albeit with Excel.

If you are hardcore you could unzip the docx and version control the files within

matt_the_bass
We use git for all our code and svn for our electrical design files. These work reasonably well for engineers but not for non-engineers (sales, marketing, admin, corporate). We tried using svn with word processing files (word and open office). This generally sucked.

So we’re tryig something new: google docs. Recently we migrated our file server to google drive and have been moving from open office to google docs.

Google docs works great for light weight version control of non-engineering documents. Just name a revision as x.x.x and only distribute named revisions. This obviously only works for documents with a single “branch” but for 99.9% of our non-engineering version control needs, this works GREAT!

acutesoftware
Any sort of versioned online wiki tool is better than word documents with filenames - this can be your own wiki, or sharepoint or Drive.

Non tech savvy users can read the page to see the latest version, and others can track through history if they need to.

We've had success doing smaller projects completely on trello, though it isnt really a wiki tool, you can force it by having a single top level card with all the feauture requests linking to individual cards to see the progress.

rashidujang
We actually have a Sharepoint page but somehow have been uploading the documents according to their versioning since the beginning of the project.

Any idea how to get coworkers on board with using the version tracking feature?

JanisL
If a document is super important we make sure that it's only worked on in a system that support some form of version control. But that's fairly easy for us because we pretty much all are comfortable with Git. In the cases where people simply won't learn Git I find going with some sort of web-based version controlled documents is a massive win.

Whatever you do avoid situations where people email around attached documents with various changes, set strong expectations that emails like that are not to be used. Most of the troubles I've encountered have been because of the inevitable merge conflicts and associated hassles from divergent documents that occur with email attachments.

digikata
If you just need a little duct tape hack for your situation, you can setup a script to scan the folder and point some html page of links to your latest doc set. Could even as simple as a generated static html file named to appear at the top of the folder or folder tree in a known place.

Communicating and agreeing on some commonly understood system is typically a more effective factor than the tooling.

[dead] whatsstolat
If you use Word this is something where SharePoint is useful. Overall I prefer confluence. In an ideal world git+markdown/latex would be awesomesauce. But that's no so compatible with business folk or customers.