Ciaran Connelly
About Plain Text Law Plain Text Time Tracking Archive Replies Also on Micro.blog
  • MultiMarkdown headings for contracts can also be tricky because there is no direct way to indicate whether or not the headings should be numbered, or how that numbering should work. (1.1.4 v. I.A.1.a etc.)

    → 8:29 AM, Sep 1
  • MultiMarkdown signature blocks are not all that difficult. The hardest part is getting nice signature lines. Escaping underscores seems to be the easiest way, though getting the right number remains a challenge.

    → 11:42 PM, Aug 31
  • Numbered cross references in MultiMarkdown are tricky

    In MMD you can make a cross-reference using [][name of section] where name of section is a section title (or a reference name specified in brackets), but there’s no good way to refer to the section number.

    For example, in a document with a section called “Preamble” you can type:

    "Member" has the meaning ascribed in the [preable][Preamble].
    

    But you can’t type:

    "Member" has the meaning ascribed in Section [number??][Members].
    

    The number is uwknown until the MMD document is processed into another format, and MMD doesn’t provide any shorthand for that number—only a way to refer to the section name.

    A script might be able to add those references in—manually inserting numbers by counting up by section—but that script is an extra moving piece that would have to be developed.

    Getting a reference to the section number in LaTeX, however, is easy. So the challenge is how to get an intuitive reference to the section number in MMD that LaTeX will properly recognize.

    → 5:42 PM, Aug 30
  • Towards a legal markup language

    Court-mandated styles may require adding:

    • line numbers (reset by page)
    • footers with document title and counsel information
    • caption blocks with court names, case numbers, titles, and party names).
    → 7:03 AM, Aug 29
  • Towards a legal markup language

    What markup do we need for pleadings?

    • everything from contracts, plus:
    • footnotes
    • cites/table of authorities
    • a caption block

    (We’ll deal with court-imposed formatting requirements separately.)

    → 6:23 AM, Aug 28
  • Towards a legal markup language

    Starting simply: what markup do we need for contracts?

    • Sections, subsections, subsubsections
    • Cross references
    • Signature blocks
    • A table or two (maybe)

    That’s really about it.

    → 2:21 PM, Aug 27
  • To take a step back, a plain text legal solution must:

    1. Use markup that gives easy access to most semantic elements a lawyer needs to write.
    2. Add a styling language or template that interprets 1 and adds any missing components.
    → 6:06 AM, Aug 26
  • MultiMarkdown adds several key abilities to a plain text legal workflow:

    • tables
    • footnotes
    • cross references
    • tables of contents

    Each has limitations, at least in its MMD form. (Just try making a case caption block in MMD.)

    → 9:53 PM, Aug 25
  • Potential components of a plain text legal solution:

    • Multi-Markdown
    • git
    • pandoc
    • LaTeX
    • HTML/CSS
    • Racket/Pollen
    • scripts (javascript or python)

    I don’t think all of those will be needed. But they might be.

    → 9:39 AM, Aug 24
  • LaTeX is too complex for lawyers to adopt

    Where Markdown is not sophisticated enough, LaTeX is too complex for lawyers to make a habit of writing in it everyday. We need to marry Markdown’s ease of use with LaTeX’s layout power.

    → 10:16 AM, Aug 23
  • Markdown isn’t enough for plain text legal documents.

    Markdown is meant to be an easy way to write basic HTML using minimal, human-readable markup. And it’s great. But more is needed to get proper, paginated, rich-text legal documents.

    → 11:39 AM, Aug 22
  • One solution: Just paste plain text into Word, and apply a set of pre-defined styles saved in a blank template. This works, but is tedious, time consuming, and error prone. (But I’ll admit that this is sometimes the best way to reformat a .docx with hopelessly FUBAR’d formatting.)

    → 9:58 AM, Aug 21
  • Any solution for using plain text for legal work must: (1) allow us to convert plain text to paginated, rich-text final documents; and (2) do so in a way that doesn’t destroy the advantages of working with plain text in the first place.

    → 9:48 AM, Aug 21
  • Challenge No. 3 of using plain text for legal work:

    Collaborating. Your colleagues, co-counsel, opposing counsel, clients, and even the courts all expect you to use .docx for editable documents.

    → 6:22 AM, Aug 20
  • Challenge No. 2 of using plain text for legal work:

    The end product must be paginated. Legal documents include header, footer, page number, table of contents and of authorities, margin, font size, and even line number requirements.

    → 6:27 AM, Aug 19
  • Challenge No. 1 of using plain text for legal work:

    The end product must still be rich text. A contract to be signed; a brief to be filed. All require some amount of styling to be easily read. Plain text doesn’t provide that inherently.

    → 7:17 AM, Aug 18
  • Reason no. 5 to prefer plain text to .docx for legal work:

    Plain text is a common denominator. Almost any tool can generate plain text. CLI/GUI/dictation/scribbling on an apple watch. You don’t have to worry about compatibility.

    → 7:53 AM, Aug 17
  • Reason no. 4 to prefer plain text to .docx for legal work:

    Archiving is better. Plain text files will be just as usable, readable, and searchable in 10 years as they are today. (RIP .doc, .wpd, etc.)

    → 7:21 AM, Aug 17
  • Reason no. 3 to prefer plain text to .docx for legal work:

    Lawyers are bad at Word. Most lawyers do not know how to use styles properly. Those that do often insist on using bad styles. Fixing formatting takes too much valuable time.

    → 10:41 AM, Aug 16
  • Reason No. 2 to prefer plain text to .docx for legal work:

    Automation. Scripting and automating plain text documents is much easier and more flexible than automating .docx binaries. And there are far more tools to work with.

    → 7:05 PM, Aug 15
  • Reason No. 1 to prefer plain text to .docx for legal work:

    Version control. It’s much easier and less expensive to store and compare versions of plain text documents (using git or otherwise) than it is to do so with .docx binaries.

    → 3:28 PM, Aug 15
  • I’ve been playing around the edges of trying to adapt various plain-text technologies—everything from git to markdown—to the practice of law and the creation of legal documents. I’m not yet convinced that this is practical. But I’m going to start posting about it anyway.

    → 12:07 PM, Aug 14
  • Looks like Apple also dropped the price of storage upgrades to the Mac Mini today.

    Going from 256GB -> 1TB is now $400, not $600

    → 6:39 AM, Jul 9
  • Another iOS 13 request:

    Dark mode is all well and good, but I want it to automatically switch based on ambient light (much like OmniFocus/Things/Drafts do today)

    → 9:35 PM, Jun 3
  • Prediction: Voice control of iOS in iOS 13 forms the basis of full iOS scripting in iOS 14.

    → 6:44 PM, Jun 3
  • RSS
  • JSON Feed
Mastodon