News for hackers. Stuff that matters.
Re:Show HN: Magistrate – Plaintext legal contracts for devel... by LiquidSky on Monday January 31, 2022 @02:59PM (#30153407)
>The domination of Word over contract negotiations seems crazy from my engineer's point of view.

Lawyer here: because your engineer's POV is wrong. I don't know what else to say. It comes from a lack of knowledge of how lawyers actually work and therefore what we actually need for our work. It is not identical to what software engineers need or want for theirs.

The drafting process is the area in transactional practice that least needs "disruption". The process is long-settled and fairly universal. Track changes are not "crazy confusing to parse", they're a simple and easy way to know who edited what and when. Version control? Basically meaningless for lawyers. The only version of the contract that matters is the most recent one, so we just need a way to track that. In actual practice we don't just revert back to some older version; that doesn't even make sense to someone who understands what we're doing.

What really needs disruption, or at least improvement, are contract management platforms. I've worked with all the major ones and they're all pretty bad and clunky in their own way (IME Ironclad is the least-worst but still leaves much to be desired).

If someone could develop a simple, intuitive system for extracting and recording certain agreement content and making that searchable (and transferable!), as well as storing and searching agreement documents generally, it would be amazing.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by FrobeniusTwist on Monday January 31, 2022 @07:16PM (#30156851)
Another (transactional) lawyer here. While I generally agree with this, there are still circumstances in which something like a VC system would be useful. It's not uncommon for documents to go through a dozen or more (sometimes significantly more) iterations before being finalized. It would sometimes be useful to know in which version a particular fragment of language was inserted. But this can be worked out "manually", and indeed I think the real issue is that the value add of a VC system is probably small enough that it's just not worth any significant additional complexity. Having said that, I've long considered doing a lunchtime brownbag session on git, just to blow people's minds about what is possible.

I do disagree about "Track Changes" though. That quickly becomes an incomprehensible mess. Better to avoid Track Changes (except in very small/simple agreements where you don't expect more than one or two turns, in which case it can be useful) and send a "clean" and redline version (based on the immediately preceding version) on each turn.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by marwis on Tuesday February 01, 2022 @10:42AM (#30163990)
SharePoint has version control for Word documents. It's better suited for that than Git.

Also, mailbox full of back and forth emails with successive versions of document in attachments is also a version control system. It just needs better tooling.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by NoboruWataya on Monday January 31, 2022 @04:31PM (#30154742)
> Version control? Basically meaningless for lawyers. The only version of the contract that matters is the most recent one, so we just need a way to track that.

I think you are talking about versioning executed contracts, in which case I kind of agree with you, though there are some corner cases where it would be helpful to track all the amendments/restatements to a contract over time.

But I do think versioning of drafts is important in all but the most basic negotiations because parties expect redlines with each draft and different parties may expect different redlines (because not all parties are necessarily recipients of all drafts, eg, if there are some discrete points being negotiated amongst a sub-set of the parties).

But as I have said in another comment, that kind of version control is already available to lawyers. And in general, I agree with you - the actual pain points for lawyers (and their clients) are not the ones that software developers tend to focus on when they talk about disrupting the legal sector. There are a lot of solutions in search of problems.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by jcelerier on Monday January 31, 2022 @03:43PM (#30154017)
> The only version of the contract that matters is the most recent one, so we just need a way to track that. In actual practice we don't just revert back to some older version; that doesn't even make sense to someone who understands what we're doing.

so every lawyer on earth is able to use word 100% of the time without ever losing data, removing a sentence or closing a comment by mistake ?

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by LiquidSky on Monday January 31, 2022 @03:56PM (#30154209)
A glib response to a glib question: frankly, yes.

This is not an actual problem in real-world practice. Change tracking is easy and fairly universally understood. I see this idea from engineers that what lawyers do is try to slide in secret edits and a lawyer’s job is to be ever-vigilant for these secret attacks, but this is not how lawyers actually work.

Only non-lawyers imagine this is some huge issue that lawyers grapple with and for which they cry out for a solution. Again, it really would behoove any would-be saviors of the legal profession to engage with actual practitioners and listen to what their actual problems are, not what you strongly feel they must be.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by trowawee on Tuesday February 01, 2022 @01:18PM (#30166733)
I dropped out of law school before ending up in tech, but my parents are lawyers, my sibling is a lawyer, a large chunk of my social circle are lawyers, and I act as a go-between connecting my lawyer friends and family with non-lawyer friends who need some legal help (and also someone who speaks lawyer fluently enough to translate to normal people). All of this is just to say that the ideas that:

1) change tracking is easy to use and universally understood 2) timestamps in document names solve the version problem, and 3) that emails traded back and forth work as a document history

does not at all mesh with my experience or with the complaints I hear from friends and family in the legal profession. Even just when I'm helping friends in software negotiate contracts, which usually just involves me, one other engineer, and one lawyer, changes pretty frequently get lost or go unnoticed. Versions frequently get mixed up (altho the blame for that usually falls on bad search engines in email clients). Lawyer friends have complained to me about conflicting timestamps and about larger documents with hundreds of changes being tracked that work slowly and are difficult to parse.

I definitely think engineers are too quick to throw a "one easy trick!" at a big messy problem like this that obviously has a bunch of social/network elements in addition to technical challenges, but saying that the current situation is functional for most participants doesn't really seem to be accurate.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by jcelerier on Wednesday February 02, 2022 @05:44AM (#30175946)
> does not at all mesh with my experience or with the complaints I hear from friends and family in the legal profession. Even just when I'm helping friends in software negotiate contracts, which usually just involves me, one other engineer, and one lawyer, changes pretty frequently get lost or go unnoticed. Versions frequently get mixed up (altho the blame for that usually falls on bad search engines in email clients). Lawyer friends have complained to me about conflicting timestamps and about larger documents with hundreds of changes being tracked that work slowly and are difficult to parse.

that is exactly my experience with any shared document > 20 pages in word

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by afarrell on Monday January 31, 2022 @04:15PM (#30154473)
I'm going to name the phenomenon you're arguing against "UX projection".

As a software engineer, when I imagine myself doing a lawyer's job, I would want a tool like this. But that misses the point. Good UX requires first being attentive to the actual problems expressed by users. Otherwise we end up with the pretense of empathy: projection.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by Aeolun on Monday January 31, 2022 @05:34PM (#30155673)
> Again, it really would behoove any would-be saviors of the legal profession to engage with actual practitioners and listen to what their actual problems are

That may be a good idea, but not because they’ll tell you what their problems are. Asking people what their problem is leads to responses like ‘faster horses’ instead of ‘cars’, and this whole Word situation reeks strongly of that.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by LiquidSky on Monday January 31, 2022 @05:47PM (#30155839)
That's funny, to me it reeks strongly of solutions in search of a problem.
Re:Show HN: Magistrate – Plaintext legal contracts for devel... by jcelerier on Monday January 31, 2022 @03:59PM (#30154249)
> A glib response to a glib question: frankly, yes.

that's wild. My experience editing word documents is that you have to have a dozen backups to be sure not to loose something due to basic keyboard / mouse manipulation mistake. I wonder what is their secret.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by LiquidSky on Monday January 31, 2022 @04:11PM (#30154426)
Try updating your version of Word, it sounds like you’re having some rather severe technical issues.
Re:Show HN: Magistrate – Plaintext legal contracts for devel... by jcelerier on Monday January 31, 2022 @04:51PM (#30155021)
It's not a problem with word, it's a problem with anything that allows keyboard input. There's not a week where I don't see a mistakenly removed line for instance when checking a diff before commiting.
Re:Show HN: Magistrate – Plaintext legal contracts for devel... by bdowling on Monday January 31, 2022 @08:45PM (#30157587)
> The only version of the contract that matters is the most recent one ...

Replying to add that there is a simple reason for this: Virtually every written contract includes an "integration" or "whole agreement" clause that states that the current version is the final version of the contract and that it supersedes any prior oral or written agreements between the parties.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by jontas on Monday January 31, 2022 @06:01PM (#30156020)
If you ever want to chat about your ideas on contract management, hit me up. I'm an NYC based software engineer, email in profile.
Re:Show HN: Magistrate – Plaintext legal contracts for devel... by dctoedt on Monday January 31, 2022 @04:17PM (#30154519)
> The only version of the contract that matters is the most recent one, so we just need a way to track that.

Another lawyer here: This is correct. (To uniquely identify the most recent version, it's extremely helpful to hard-code the date and time into the file name and in a running header. EXAMPLE: "ABC-XYZ-NDA-markup-2022-01-31-1510-CST.docx" (or use UTC if dealing with other countries' time zones).

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by Aeolun on Monday January 31, 2022 @05:31PM (#30155636)
The moment you start doing this, git becomes the better solution, no?

If multiple parties are mailing word documents back and forth (even with date in title), it becomes crazy.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by dctoedt on Monday January 31, 2022 @05:45PM (#30155802)
> The moment you start doing this, git becomes the better solution, no?

You think J. Random Lawyer is going to learn, and use, git? ROFLMAO — half the lawyers around don't even know how to use styles in Word, and they think the way to add spacing between paragraphs is to leave a blank line.

Re:Show HN: Magistrate – Plaintext legal contracts for devel... by zie on Monday January 31, 2022 @09:27PM (#30157865)
+1, Many developers can barely use git.
Re:Show HN: Magistrate – Plaintext legal contracts for devel... by LiquidSky on Monday January 31, 2022 @05:41PM (#30155751)
Nah, we do the same thing the parent does with file names. Works just fine.