Domain: altova.com
Stories and comments across the archive that link to altova.com.
Comments · 8
-
Re:Oh no...
Then I will check my mail with XMLSpy.
-
Knowledgebase toolsets
Having been a technical writer in the computer industry for over twenty years, I can tell you from experience that the best approach is to (1) set up a wiki for technical folks to contribute content and simultaneously (2) use a professional technical writer to build and maintain a knowledgebase drawn from that wiki content and code comments, plus their own interviews, research, diagramming, and writing.
Do not try to solve this problem using traditional desktop publishing tools, except as a short-term stop-gap measure. Find a technical writer who understands both relational database and XML technology, and put them to work using their preferred toolset.
Some knowledgebase toolset notes follow.
Adobe RoboHelp Server 8 can be the delivery mechanism for an enterprise-wide knowledgebase and RoboHelp 8 can be the authoring environment --
http://www.adobe.com/products/robohelp/
http://www.adobe.com/products/robohelpserver/
with various additional authoring and diagramming tools serving as content creation editors, especially to cope with producing documents needed urgently, albeit in desktop publishing mode.
While RoboHelp got its start as a Windows online help editor, it has, like the gawky teenager next door, grown into an impressive adult over the past few years.
A competing product you (and your technical writer) should also look at is Macap Flare, which was developed by a group of software developers who spun off from RoboHelp a while back.
(RoboHelp had been successively owned by Blue Sky, eHelp, Macromedia, and now Adobe, with the all the personal stress such corporate buy-outs, and the resulting rebranding code-churn, can induce.)
Madcap Flare is also part of a knowledgebase-creation toolset that will soon have its own content management server as a delivery and workflow mechanism --
http://www.madcapsoftware.com/products/flare/
http://www.madcapsoftware.com/products/teamserver/
The Altova XMLSpy toolset is also worth evaluating --
http://www.altova.com/solutions_center.html
Don't expect your techies to spend their time in Altova, Flare, RoboHelp (or whatever), since their time is much better spent writing code and comments and any descriptions they can generate, in tools they already know and love, such as wikis and their favorite IDEs.
But do expect your technical writer to follow along and clean things up in a high-end knowledgebase toolset, and, eventually, to set up a workflow process for copyediting and approving new and updated material, but in as unobtrusive a manner as possible.
Also be aware that your knowledgebase will likely need to be translated into multiple languages, with the advice and assistance of localization specialists.
It sounds like your technical writer will be doing catch-up -- it has typically taken me about 18 months to get things under control and flowing smoothly in any company that neglected to hire a technical writer from the beginning, all the while jamming out whatever documents were needed for product delivery using standard desktop publishing tools.
This is not a life to envy, or for the faint of heart, but it can be an adventure for the truly dedicated. Bringing order out of chaos with your keyboard can be a rush.
-
Re:Text Conf Files for Windows
No, they'll just use something like this to edit it, or more likely some MS GUI tool.
-
Re:Not really new, but interesting
Please STFU. I doubt you've ever made a single website or written a single line of javascript code. Otherwise, you would know that "standards-compliant" just means that it doesn't work correctly in any browser, since no browsers are 100% standards-compliant.
There are work arounds that you can validate for. When I took classes in html, xhtml, and javascript our code had to be valid, we were supposed to validate our pages with CSE HTML Validater and in xml we used XMLSpy . We even were supposed to have valid code when I took Dreamweaver.
Falcon -
What about Altova?
Most of the answers to the article point to PDF.
Anyone can compare with "Altova Authentic"? (see http://www.altova.com/products_doc.html). -
Re:XML/XSLT for humans?
Well... XMLSPY is one choice. The enterprise edition comes with "Sylesheet Designer" (which has since been renamed "stylevision" me thinks) in the last update. It is supposed to be a WYSIWYG editor which includes tags to your xml schema. My experience is with stylesheet designer...its buggy, it takes lots of tweaking, but again its a helluva lot better than doing it by hand.
-
Some alternatives
I m not counting on MS Office Suite to provide me with a XML editor. Here are some alternatives:
DocSoft's W2XML Version 2
Authentic by Altova
i4i Tagless Editor
XMLWriter by Wattle Software
Opensource Extensible XML Modeling Application
If you know of any other GUI based XML modeling/editing apps, please feel free to add them to this list. -
a listAs it happens, I was doing some surfing for document-oriented WYSYWYG/WYSYWIM XML editors myself. I'm a little late in the discussion, so a couple of these have already been mentioned, but here's the list I've got so far (I've not tried them all):
- Arbortext Epic Editor
- SoftQuad XMetal or Corel XMetal
- EpcEdit XML/SGML Editor
- Altova Authentic
- XmlMind XML Editor (Standard version is free)
- Morphon XML Editor
- TimeLux XPress
- GenDoc (open source, could be nice if someone wrote a docbook plugin)
- Conglomerate (open source project which seems to be resurrected, nothing available now though)
- ExcoSoft XML Client (as far as I can tell from the website...)
- SoftMagic SendStory
Anyone has experience with these? (or others that are missing from the list).