One of a Kind HTML Editor
Updated August 14, 2017

One of a Kind HTML Editor

George Eckel | TrustRadius Reviewer
Score 8 out of 10
Vetted Review
Verified User

Software Version

MindTouch 4

Overall Satisfaction with MindTouch

MindTouch is used for internal-only as well as external documentation for corporate services. Documents are user guides, getting started guides, etc. Internally, service developers create the MindTouch documentation or a technical writer does. The external documentation is created by a technical writer. Users are internal devs for the internal products or third parties developing on top of our services for the external docs. MindTouhc provides an easy to use the editor to document complex software products.
  • Versioning-- so you can roll back or compare to previous doc versions.
  • Customer support-- friendly and timely, I get emails and/or calls usually within hours of submitting a support request.
  • Linking, permissions, image handling, table creation -- all of the basic tools needed to create documentation.
  • Oddly, MT disallows h1 heading tags that you enter, MindTouch downgrades to an h2 heading tag.
  • Link checking is missing because when third party tools try to check links, MindTouch will create a bogus page so the link doesn't break. But we'd like it to break so we know the link is broken. Linking to bogus pages is unhelpful.
  • The editor tool bar remains on the top of the UI. So, many times, you have to scroll to the top of the screen to do things that would be very simple if the toolbar floated on the top of the screen.
  • Documentation is not a function of the tool but the quality of the writing
  • Good documentation has led to teams not answering questions from other developers
  • Bad documentation leads to teams being asked the same questions over and over, or their services ignored.
MindTouch is not as sophisticated as those editors but MindTouch is the only one that generates HTML. The other editors provide additional, advanced functionality, are more bulletproof, and require the services of an experienced technical writer. MindTouch, however, is simpler and covers most if not all of the bases that writers use every day.
It's very good for general documentation. I don't know of any other HTML editor that's as sophisticated. It won't replace embedded docs, like Swagger. And because everyone is switching to GitHub, lots of developers will prefer to put their docs in markdown on GitHub, which leaves MindTouch in the cold. But for technical writers, MindTouch's complexity is great. In summary, MT is a very good product for Tech Writers who want to author in HTML.

Relationship with MindTouch

Fast, good action on bugs and simple matters. 6 months waiting for critical fixes.