Posts Tagged ‘software’

KRONOS – Evaluation Criteria for Software and RocketMatter

I recently engaged in a long conversation with Larry Port of Rocket Matter about the state of software design, and the common disconnect between programmers, marketeers and end users.  It turns out Larry was a specialist in “usability studies” – the new buzz word in software design. He pointed me to TED.  At that time I recalled a series of ABA Techshow and other presentations I made back in 2001 on how legal software should be evaluated. I reproduce my unedited article from 2001 below, with the caveat it is not Web 2.0 aware …. But will in the future revisit some of theses ideas, particularly in a forthcoming review in Technolawyer of RocketMatter.

In evaluating technology, I look for inspiration to the Greeks, and in particular the father of the gods on Mt. Olympus, none other than KRONOS.  I use the following criteria in evaluating all technology:

Keystroke Count. The tool must be easy to use.  A subjective judgment on ease of use can be reduced to an empirical keystroke count.  In comparing similar tools, count the number of keystrokes (or mouse clicks) require to accomplish regular tasks.  The fewer the keystrokes, the better designed the software, and the more likely it will be used properly.

Return on Investment. The tool must pay for itself in increased productivity, improved work product, greater client satisfaction, or more efficient organization and information retention.  Don’t just look at price per seat.  Look at the “total cost of ownership” (equipment requirements, training, support and customization) and compare it to the expected return on investment.

Opulence and Intuitiveness. The tool must be “good looking”.  An ugly interface is often a proxy for poorly designed and thrown together software.  If the developer did not take the time to build an elegant and appealing interface, the developer may also not have taken the time to fully test and debug the software.  Also, if the icons, menus, and screens are not intuitive, you may find yourself spending a fortune on training, and your users may never fully utilize the potential of the software.

Networkability and Integration. The days of stand-alone PC’s are over.  The tool must function in a networked environment, and allow multiple users to access the system simultaneously.  And the tool should be able to communicate with other programs, sharing or exchanging data.

Options and Customization. It should be easy to install software, with a single CD-ROM and a menu of options to allow you to configure the software installation for the requirements of your network/PC.  A good software designer recognizes that each IP practice is unique, and should allow for some degree of customization, whether the addition of custom fields or the ability to modify or add new templates.

Suitability for the Task. The tool must be designed for or configurable for the specific use desired by the practitioner.  A general purpose case manager is a poor substitute for an IP portfolio database.

EPMS: A Tool for Estate Planners and Elder Lawyers

I have generally kept this blog free of product promotions and endorsements (not to mention split infinitives).  Basha Systems LLC has recently added a treasure trove of information to its main website (www.bashasys.com) and a new subdomain (http://estateplanning.bashasys.com) and added products to the web store (http://store.bashasys.com).  I encourage you to look at those sites for your edification and our possible remuneration.  But I should let you know that Basha Systems LLC is in the process of transformation from focusing predominantly on technology consulting to a product development company.  Don’t worry … we will continue to provide consulting services. It pays the bills; its fun; and it gives us ideas for product development.

In the past several years, we have helped launch Interactive Legal Systems LLC’s “Lifetime Estate Planning System,” also known as Wealth Transfer Planning (“WTP”).  We have designed and built a commercially available probate system in conjunction with the Nebraska State Bar Association, which is used in over 120 law firms.  We have served as advisor to the Minnesota State Bar Association in the development of a suite of forms that will soon be made available as a member benefit. We built a “Record Room Management System” and “Litigation File Management System” add-ons for Time Matters.  We are currently developing under contract to ILS a comprehensive elder law planning system for elder lawyers.

And yesterday, we officially launched a new product in conjunction with Interactive Legal Systems.  The Basha Systems “Estate Planning Management System” for the software formerly known as Time Matters® is a complete system for estate planners and soon for elder law attorneys that builds on the best features of Time Matters® and HotDocs®.  The original conception was to turn Time Matters into a data source to feed the client interview in WTP.  Based on discussions with numerous attorneys, the client and spouse contact form styles evolved into a complete estate planning management system built as a feature package on top of the software now known as LexisNexis Front Office powered by Time Matters. If this area is of interest to you (or your clients), please take a look at our new subdomain, and in particular (http://estateplanning.bashasys.com/timematters).

The EPMS system represents hundreds of hours of work for three programmers with specialties in HotDocs®, Time Matters® and Javascript/HTML. And yet, the system can be installed in under 30 minutes, with a live web-based training class to follow immediately.  Basha Systems has taken its own Kool-Aid® and invested substantial “non-billable” hours to produce a high-quality product.  Take a look and let us know what you think.  Or contact us, to arrange a live-demo.

Migrating from Legacy Document Assembly Systems

Over the past decade, document assembly systems have come and gone.  Some, like HotDocs 4.2, HotDocs 5.x, CAPSAuthor, WinCAPS, SmartWords, Agility, FastDraft, Form Bank, MasterDraft, MillRace, NovaDocs, PowerTXT, Scrivener, ThinkDocs, and WorkForm, are no longer supported.  Some like GhostFill, ProDoc, WinDraft, and Perfectus have only a small developer community that provides limited support. Others, like WordVBA and Wordperfect have macros tools that require dedicated technicians to support and maintain. Yet other systems, like Pathagoras, D3 and qShift lack support for traditional programming techniques like repeat loops, nested IF statements, and variable scripting.

The result is that thousands of legal templates are locked in poorly supported legacy systems, representing hundreds of thousands of hours of programming and invaluable legal workproduct.  This article explores a process of identify and extracting the business rules and workproduct from these legacy systems and moving them to more powerful and better support platforms such as HotDocs or DealBuilder.

At root, all document automation systems are the same.  They address the same fundamental issues: which documents, paragraphs, and phrases to include in output document and what data to use to fill in the blanks.  The hard work in document assembly programming is NOT the programming, but rather crafting the business rules which govern whether to include or exclude text and how best to fill in the blanks.

It is for that reason that we have developed a universal approach to marking up documents and document automation interviews that can work with any document automation system.  This approach allows us to take templates in legacy document assembly systems: (1) identify and catalog all the conditional rules, (2) identify and fully describe all the variables (by function, type, prompt and defaults), (3) identify all the dialog objects and scripts, and (4) extract all the text objects, clauses and subdocuments.

From there we structure in Excel a prototype interview in HotDocs, GhostFill or DealBuilder) that mirrors the functionality of the legacy system.  In describing each new variable, object, script in the new platform, we maintain a reference to the comparable object in the legacy platform.  Once the interview and datastructure is completed in the new platform, we turn to the text objects, clauses and subdocuments.  Where possible, we have preserved the markup of the legacy platform in the text documents.

We generally consolidate the text objects into master templates so that they are more easily edited as a whole.  Where text objects are used in multiple templates, we keep them separate and use INSERT or INCLUDE commands to bring in the text where appropriate.  As part of the process, we also strip the text of all formatting and then carefully apply a Word style sheet using outline schemes, paragraph styles and character styles to handle ALL text formatting, spacing, letting, kerning, outlining, numbering etc.  This allows use to use the stylesheet pro grammatically to change the document templates and the assembled documents.

There is a tendency to want to “throw out the baby with the bath water” when a firm decides to adopt a new document assembly system.  While the process described above TAKES time and planning, it does preserve the MOST valuable part of the automation process, the attorney time and workproduct.  If you have a system that WORKS, but is old and dated, it is best to use that as a base for the new system, rather than to scrap it entirely.  That gives you a result that will WORK when delivered.  And then, you can have fun, spend money, adding in the new features and enhancements that the new document automation platform offers.

LEGACY DOCUMENT ASSEMBLY PLATFORMS

HotDocs 4.2 & HotDocs 5.x: LexisNexis no longer supports these early Windows versions of HotDocs.  Hundreds of thousands of licenses to HotDocs were bundled with WordPerfect Legal Edition. Early HotDocs had limited scripting and presented questions in a series of popup-dialogs as the document was assembled from within Word or WordPerfect. With HotDocs 6/2005/2006/2007, HotDocs transitioned to a single interview object and moved the assembly outside the word-processor into an RTF-Assembler.

CAPSAuthor & WinCAPS: Once the best and most advance document assembly platform for MS-DOS.  CAPSAuthor still runs in a DOS-window.  WinCAPS is the assembly environment, built to run in Windows 3.1 on a 16-bit platform.  There were hundreds of systems built with CAPS, including several that were sold commercially.  We were responsible for converting one CAPS system, Drafting Wills and Trust Agreements (“DWTA”) from WinCAPS to the GhostFill platform.  We have also converted a document lending system that had over 5000 CAPS objects into GhostFill. The process of extracting the business rules, text and variables used for those conversions, could just as easily been applied to converting those systems to HotDocs.

SmartWords: Built on bTrieve and Xyrite, a very sophisticated engine. When the owner went out of business, the software was taken out of circulation.  Two years ago, Basha Systems converted Wealth Transfer Planning, the one commercially viable product built on Smartword, to the HotDocs platform.  That content is now owned by Interactive Legal Systems, which built a custom wrapper around the HotDocs templates that expanded on the document and answer management features of the original software.

Agility, from RealWorld Solutions, was a DOS-based product most suitable for offices using pre-Windows versions of WordPerfect.  The program had a deliberate strategy of simplicity.  Agility included most of the basic features one would expect in a document assembly tool, including nested logic and repeat loops.  But as there is no Windows version, non integration with any word processor, and no math functions it lacked viability for search document assembly applications.

FastDraft, from Interactive Professional Software, allowed a user to select a type of document, choose from available clauses and then fill in the blanks in the selected clauses.  The user could reorder the clauses and easily back up to previous steps in the process.  In this way, it was similar to the more powerful qShift.  FastDraft lacked features that make sophisticated rule-based practice systems, such logic, math functions, and validation of dates and numbers.

ThinkDocs started out as a graphic forms engine, which applied the concept of data stored in a database and hooked “live” into the assembled document.  It used DocVariables in assembled documents to retain a live-link to “answer data” stored in a database after the document was assembled.  As such, the system lacked any support for conditional logic on text in the template, unless the text itself was stored in the database and used to set the value of a DocVariable in the assembled document.  ThinkDocs appealed to users because of the “live” link—but in practice such live links worked only with simplistic documents – those templates lacking any complex embedded logic.

Form Bank, from now defunct ExperText Systems Ltd, was developed by Doug Simpson.  It made clever use of an automated teller metaphor, with developers depositing materials into the system, users withdrawing them, and a :”bank manager” determining who can do what.  It depended on Microsoft Access for a database of clauses, questions and other components that could be shared across multiple forms and managed by a group of cooperating users.

MillRace, from Old Mill Software was designed to allow attorneys to build documents by combing through annotated collections of forms and clauses, based on client requirements and negotiated issues.  It rejected the “QUAIL” – question, answer and imbedded (sic) logic – approach of most document assembly system. Development was ceased in 1997.

NovaDocs, from Novation Corporation in was conceived by James Conger.  It provided the basics of document assembly in an easy-to use and attractive package that exploits such features as collapsible outlines and drag and drop. Clauses and questions could be edited on the fly while assembling documents and making for little distinction between developer and user modes.  However, it lacked conditional logic, repeat loops, answer validation and other features standard in most document assembly engines.

PowerTXT, from Intercon Associates, Inc. was a feature rich, and easy-to-use program that evolved from FlexPractice, a popular DOS-based document assembly program in the 1980s.  In PowerTXT, model documents showed up as graphical outlines on the screen.  After users point and click thyeir way through necessary decisions, questions are asked that gather the details needed to assemble the desired documents.  The program did not support traditional programming techniques like repeat loops and nested IF statements.  Those who liked the outline and document-model structure of PowerTXT, would like IXIO.com’s qShift document modeling software which places clause libraries and document models on a privately hosted and secured web-server.

Scrivener was created by Dan Evans.  It was distinctive in being build on a true rule-based expert system engine and was among the first document assembly products to make good use of outline representations of document structure.  It provided support for incremental model revision as you use the system in everyday practice.

WorkForm and Visual WorkTool, developed by Analytic Legal Programs, Inc. was a powerful set of document assembly tools was a dominant player in the 1980s.

DOCUMENT ASSEMBLY PLATFORMS LACKING TRADITIONAL PROGRAMMING TOOLS

Pathagoras: Developed by Roy Lasris as that “alternative” to programmed document assembly. This system supports “quick and dirty” clause based assembly with rudimentary variables. If you want to build a library of “snippets” for reuse and throw some fields in, this software can save you time over traditional word processing. But to call this software document assembly suggests that this software is in the same league as HotDocs and DealBuilder (which it isn’t). That said, there is a lot of good forms built by lawyers with Pathagoras that could be made better in HotDocs.  The markup and structure of Pathagoras would make conversion fairly easy, and give users much more power and flexibility.

D3 Documents. MicroSystems SQL-Based clause manager and form filler is a great tool for fitting into the workflow of simple documents.  As a replacement for WordVBA and macros, it is a major improvement, serving as the glue for all those communications and simplistic documents.  What D3 does not support is traditional programming techniques for nested IF statements, loops, repeats and while statements, as well as script objects.  However, it represents a good start in that it forces the user to identify the data necessary for assembling templates and actually choosing and structuring the model language that will form the basis of the template.

qShift.  IXIO built a system that I would have loved to use when I was practicing law a decade ago.  It automatically takes a well-structured agreement, and breaks it into its constituent elements and presents a document model to which you can then apply automation rules.  We have reviewed it elsewhere.  It is great for choosing and crafting and dynamic form which will then be customized to a particular clients needs in a word-processor.  However, it lacks support for traditional programming techniques used in document automation software: multi-variable conditions, nested IF statements, computed variables, variables that share the same data source but are displayed differently, and full string and arithmetic manipulation capability.

WinDraft, from Eidelman Associates, was innovative and powerful when it come out in the 1990s.  It accomplished, inside the WordProcessor a level of dynamic automation that it took the other document assembly software years to catch up to.  However, the website (www.lawtech.com) hasn’t been updated in several years.  It’s business logic works with a simplified document markup and structure that did support nested logic and variables.  As such, the systems can be easily converted to HotDocs and DealBuilder.

CONTENT SYSTEMS:

DL Drafting Libraries: This proprietary form set, originally in DOS, but now in Windows, represents the “TurboTax” for
LawGIC
WealthCounsel

Wiki Wiki Wiki

For the past several years I have been running a virtual office with collaborators in multiple locations.  We have tried a number of collaboration tools, including GoToMeeting and GoToMyPC, Groove, Time Matters World, with mixed success.  Most of the work was project based, where control of the project files could be passed (as a football) from one collaborator to another.  This works as long as you can pass control.  However, there are times when we have needed to have simultaneous control of a project.  For those, we have now standardized on a Wiki.

What is a Wiki?

According to www.wiki.org, it is:

Wiki is a piece of server software that allows users to freely create and edit Web page content using any Web browser. Wiki supports hyperlinks and has a simple text syntax for creating new pages and crosslinks between internal pages on the fly.

Wiki is unusual among group communication mechanisms in that it allows the organization of contributions to be edited in addition to the content itself.

Our Experience

I have talking with many programmers who work with source code Wiki’s to store and organize snippets of code.  What distinguishes a good programmer from a so-so programmer is the ability to understand and “reuse code” efficiently in different environments.  By using a Wiki, code can be annotated and placed in an environment where it is made available to other coders in the organization. But this is where most “databases end” and the “wiki begins.

Because each article in a Wiki can be edited, each person who finds the code and uses it, can improve on the code … revise it.  The wiki tracks prior version.  It also tracks discussion on the particular article.  In this way, a Wiki (used in open source development) can grow to become a vital resource of what works and doesn’t work in an organization.

At Basha Systems, we have recently implemented an internal Wiki.  Every time one of us has an idea, we toss it up on the Wiki.  Someone else may look at the idea and refine it (or reject it).  The idea can then develop into a procedure, process, or utility. Commentary can be refined as the utility is used in a feedback loop which then improves the program.  The wiki software we use is called [url=http:\\www.pmachine.com]Expression Engine[\url], the same tool we use to host this website.  But there are a number of “hosted” Wikis on Yahoo, Google, and other paid sites you can use.  We keep ours behind the firewall, but there is nothing to say you could not start a public wiki for open collaboration.

LegalTech 2006 – Document Assembly

Another year has come and gone … LegalTech New York … The largest annual technology show.  Despite the emphasis on Litigation support systems, there were some notable participants at the conference presenting document assembly solutions.  HotDocs was there as part of LexisNexis’ Total Practice Management initiative; DealBuilder with it online document assembly system powered by a unique “relevance engine”; Perfectus Solutions with its browser-based IPManager document creation and delivery system; iXIO with its innovate online document modelling solution (Q-Shift); and Microsystems with its Word-ML basis document creation system (D3).

I met with each of the vendors.  Several of the products are ones that we support.  DealBuilder, DealBuilder, GhostFill, Time Matters and Perfectus.

We were impressed by the level of energy and innovation in the document assembly space.  This is not meant as a review of these products.  That will come later.  But rather, a recognition that there is some serious programming talent coming into developing document assembly solutions.  There are more tools than ever, and more powerful tools that ever to help firms and corporations provide document creation services.

HotDocs is working on HotDocs 2006. … Under the hood are dozens of new features for “true” application developers.  When the new HotDocs 2006 comes out we will review it.  For now, to see what can be done with HotDocs, please view the link below and take a tour of some of our videos.

MicroSystems, a new entrant in the space, brings D3.  This a cross between a knowledge management capture tool, clause picker and Word-ML based document assembler.  It doesn’t fit the classical document assembly template environment, being tied closely to Word-XML and SQL database engine.  It is very flexible in handling a number of the features typically handled by major Macro-packs like SoftWise, or numbering and metadata cleaners like those from Payne Consulting and Levitt & James and WorkShare. It strength is as a Word add-on, and clause management structure.  However, it is weak in handling complex logic and dialog scripting.  Rather than presenting dialogs, the D3 assembler presents the “document” as a living editable template, and then steps through the document, presenting questions seriatum as the user walks through the document.  These fields are stored as WordML tags which can be “reassembled”.  Viewed this way, it is more of an enhanced document builder tool, rather than an interview-driven document assembler.

DealBuilder just announced the release of DealBuilder 2.7 which brings to market more than 500 new features.  Key new features include a new web-based data reporting application, enhanced end-user experience on DealBuilder questionnaires, expanded use of mark-up within DealBuilder Master Documents, additional Administration features and a new, easy to deploy DealBuilder.Server installer.  We will be announcing shortly a major DealBuilder online system which we designed and built.  It is a world-class product with even more power.  It’s relevance engine is a major benefit for those authors who have not mastered (or choose not to master) dialog scripting.  The system does however, handle incredibly complex rule structures, and resolves them to determine and ask only those variables relevant to the current answer set in use.

Perfectus has a recently released new build.  It is has a powerful GUI for building Interviews.  It has powerful template set, work flow, and document management tools built into the product that make it a total out of the box on-line solutions. The tools are all .NET and XML and fully addressable.  There is a great GUI with drag and drop development.  Simple templates can be built rapidly.  More complex business logic can be built into the system.  The one drawback is that each unique rule has to be tagged and named.  Since it is using XML tags instead of a put text markup as GhostFill and HotDocs currently do (or as the DealBuilder author supports), the developer is limited by the way XML allows tags to be named.

iXIO’s Q-Shift is like an online version of D3.  It’s has a document parsing tool that takes a Word document and turns it into an on-line document model.  The paragraphs are turned into entries in a master clause banks that can be pulled together on the fly.  Clauses can be conditional, or required, at the designers election.  You can preview the clauses and build your document from the model.  Like D3 q-Shift lacks support for Dialogs … it presents the variables in single-variable dialog boxes as it runs through the assembly, and has limit support for complex business logic.

For additional information, please visit our document assembly videos where we showcase a number of applications of these products. Video Tours

Basha Search

Loading

Basha Network

Basha Product Sites