On Adobe Framemaker 9, DITA, and XML

January 23rd, 2009 / Filed Under: Uncategorized / No Comments

Adobe recently released its newest version of software geared towards technical writers, FrameMaker 9. Needless to say, I downloaded and installed the demo version of the software. When it was done, I was excited to see the interface was updated to look like their flagship products in the Adobe Creative Suite 4, complete with the CAPITAL LETTER tabbed interface (you make your software for designers; what the hell were you thinking?!). It certainly beats the existing interface, which is so quirky you wonder how anyone uses it.

Other than that, it’s the same-old Frame, which was initially UNIX-based (and it shows). The menu options are exactly the same, and there no new options to set, at least in unstructured mode. Adobe is a huge font producer, but yet Frame 9 doesn’t fully support OpenType? We tech writers like our ligatures, too.

The new features page indicates more support for DITA, the latest XML buzzword in the technical documentation community. I helped to implement a DITA workflow at a prior job; DITA and XML are not a push-button-and-get-your-doc solution. It requires a lot of work to convert existing documentation to DITA, and it should really require someone who’s an expert at this. In this economy, it’s not easy to justify that kind of cost. There is a lot of prep work required before you even write a word. For single-writer environments, there is little return on investment, and if a company’s not going to hire a second writer, there’s no way they’re going to pay for a consultant to come in and do what’s necessary. Single writers with deadlines simply don’t have the time to invest in learning all they need on company time, while maintaining their documentation.

Frankly, I think the dirty little secret of these XML-based solutions is XSL (Extensible Style Language). XSL is a programming language (no, it’s not really a language, but bear with me on this) that is supposed to separate content from formatting, much like CSS does for HTML. However, XSL is design by programming; everything is done with if-then statements. I took a course on it, and was baffled; who decided design should be done in code?

Before technical writers and writing groups push forward with DITA because it’s the latest and greatest, they really need to determine if they can afford, in both financial and stress costs, the amount of preparation, programming, and grunt work necessary to make it work for their environment. At the very least, one full-time, dedicated resource is necessary to make the move. I am a big fan of change, and usually upgrade the software i use as quickly as possible, but I’m probably not going to ask my employer to pay $399 for this upgrade.

Powered by ScribeFire.

44 Total TweetBacks: (Tweet this post)
  • pt: Os pictogramas das Olimp?adas de Londres ficaram bem legais... mas a marca ainda ? uma m****. | http://tr.im/C322 10/17/09 01:01am
  • en: Battery backup http://tr.im/sgM6 07/14/09 04:29pm
  • en: Don't use Internet Explorer; it's about as secure as swiss cheese at the moment... http://tr.im/sgm6 07/14/09 03:28pm
  • en: Obama in Ghana: Community-Organizer-in-Chief tells Africa Yes you can! http://tinyurl.com/ntthmp But first get rid of tyranny and corruption 07/14/09 05:59am
  • : (Via @arquinetwork) 07/14/09 03:17am
  • de: RT @Macnotes: Apple Netbook: Vorstellung des Mini-Notebooks im Oktober? http://macnot.es/12321 da wird ja schon lange gegackert. Legen! 07/14/09 02:33am
  • eo: Simon Pais Thomas >> fashion photography http://okm.me/1CP 07/14/09 02:15am
  • pt: Beba?a do dia! http://okm.me/1KD 07/13/09 11:52pm
  • pt: C?o com garfo na cabe?a.. q d?. http://okm.me/1Kp 07/13/09 09:43pm
  • : Hey d.. http://tinyurl.com/kpjqj4 07/13/09 09:27pm
  • pt: voc? conhece os cl?ssicos do rock? http://okm.me/1Ku indicado por @darkromp 07/13/09 09:22pm
  • en: AgentGenius: Free Website Building Sites for Realtor Dummies http://tinyurl.com/lkeyjn Full http://tinyurl.com/kpjqj4 07/13/09 09:15pm
  • en: Anthony Lister | Art http://okm.me/1Kt 07/13/09 08:41pm
  • pt: http://okm.me/1Kr eu n?o estou satisfeita e nem aceito essas coisas. 07/13/09 08:33pm
  • pt: Judia??o...Cachorro passou tr?s dias com um garfo enfiado na cabe?a.... http://okm.me/1Kp 07/13/09 08:26pm
  • it: Medonho!! A Barbie da Sthefany http://okm.me/1Jm 07/13/09 08:11pm
  • pt: As faces dos v?rus mais perigosos hoje na terra RT @kempcartunista Pandemia de corrup??o? http://okm.me/1Kd #h1n1 07/13/09 06:28pm
  • de: RT @Macnotes: Apple Netbook: Vorstellung des Mini-Notebooks im Oktober? http://macnot.es/12321 da wird ja schon lange gegackert. Legen! 07/13/09 05:47pm
  • de: http://macnot.es/12321 Ich glaube erst das ein neues Macbook "nano" kommt, wenn es da ist 07/13/09 05:17pm
  • de: Apple Netbook: Vorstellung des Mini-Notebooks im Oktober? http://macnot.es/12321 (via @Macnotes) 07/13/09 05:13pm
  • de: Apple Netbook: Vorstellung des Mini-Notebooks im Oktober? http://macnot.es/12321 (via @Macnotes) – Schaun wa mal! 07/13/09 04:26pm
  • pt: Em se tratando de talib?s, vale o olho por olho, dente por dente? http://okm.me/1JX 07/13/09 04:23pm
  • de: Apple Netbook: Vorstellung des Mini-Notebooks im Oktober? http://macnot.es/12321 07/13/09 04:19pm
  • en: AP proposes new article formatting tags for Web (AP) http://is.gd/1wQIe From the ppl who charge 12$ for 5 word quotations http://is.gd/1wQM3 07/13/09 11:23am
  • : <<link to go with my last tweet on Obama's speech in Ghana>> http://tinyurl.com/ntthmp 07/13/09 10:09am
  • pt: Hoje ? dia mundial do rock! uma ?tima pedida para a comemora??o: http://okm.me/1JM 07/13/09 07:41am
  • en: Cool animation ... assist: http://okm.me/1JJ 07/13/09 06:52am
  • is: RT @Erikinha35 RT @jessirosa RT @davinte Medonho!! A Barbie da Sthefany http://okm.me/1Jm 07/12/09 07:36pm
  • it: RT jessirosaRT @davinte Medonho!! A Barbie da Sthefany http://okm.me/1Jm #euquero, rs 07/12/09 07:34pm
  • it: RT @davinte Medonho!! A Barbie da Sthefany http://okm.me/1Jm #euquero, rs 07/12/09 07:25pm
  • it: RT @davinte Medonho!! A Barbie da Sthefany http://okm.me/1Jm 07/12/09 07:16pm
  • it: Medonho!! A Barbie da Sthefany http://okm.me/1Jm 07/12/09 07:10pm
  • : professores e diretores de SP. Inscri??es: at? 15/07/09 http://okm.me/1Jj 07/12/09 03:35pm
  • es: @gusnar http://walhez.com/7161 esta movie me cae que te va a gustar XD 07/10/09 08:40am
  • en: Trailer Office 2010: The Movie http://walhez.com/7161 07/09/09 07:54pm
  • pt: Rumores: Los primeros screenshots de Google Chrome OS http://walhez.com/7155 07/09/09 07:01pm
  • fr: Des images pour G.I. Joe : Bien qu'il ne s'annonce pas franchement ?patant, G.I. Joe : Le r?veil du Cobra - Le Jeu c... http://is.gd/1sgKI 07/09/09 05:57pm
  • : http://okm.me/1EK 07/08/09 08:24pm
  • pt: RT @davinte: Ahhh tava t?o bom...Speedy pode voltar a ser vendido em 20 de julho, afirma Anatel http://okm.me/1Ek 07/08/09 06:49pm
  • pt: Ahhh tava t?o bom...Speedy pode voltar a ser vendido em 20 de julho, afirma Anatel http://okm.me/1Ek 07/08/09 06:47pm
  • pt: Ahhh tava t?o bom...Speedy pode voltar a ser vendido em 20 de julho, afirma Anatel http://okm.me/1Ek 07/08/09 07:50am
  • en: RT @officalTila If you're tired of trifflin ass hoez and fake bitches who don't ... Read More: http://is.gd/1qziA 07/08/09 05:40am
  • eo: Simon Pais Thomas | Photographer http://okm.me/1CP 07/07/09 06:37pm
  • edmarsh: On Adobe Framemaker 9, DITA, and XML http://tinyurl.com/cjdhed 01/23/09 10:51pm

What's Your Take?