Curated for content, computing, data, information, and digital experience professionals

Category: Content creation and design (Page 63 of 70)

Technologies and strategies for authoring and editing, including word processors, structured editors, web and page layout and formatting, content conversion and migration, multichannel content, structured and unstructured  data integration, and metadata creation. 

DITA, DocBook, and ODF Interoperability?

As our readers know, we are long-time advocates of open-document formats. Over the past couple of years, we have written a great deal about DITA and formats like ODF, but we also have a lot of experience and interest in DocBook and vertical DTDs such as J2008 for the automotive industry and the various DOD standards. We are clearly reaching a point where interoperability among these standards has become an issue. Organizations are more diverse, more likely to be sharing content between operating groups and with other organizations, and more likely to be sourcing content from a variety of partners, customers, and suppliers. Needless to say, not all of these sources of content will be using the same XML vocabulary; indeed, even two organizations using DITA, for example, will likely have specialized DITA differently.

With this need for interoperability in mind, OASIS has announced a new discussion list, regarding a possible new OASIS Document Standards Interoperability Technical Committee (TC). Details on the list, including how to subscribe, can be found here.

Search Help and Usability

Preparing for two upcoming meetings with search themes (Gilbane San Francisco and Boston KM Forum) has brought to mind many issues of search usability. At the core is the issue of search literacy. Offering some fundamental searching tips to non-professional searchers often results in a surprised reaction. (e.g. When told, if seeking information about a specific topic such as “industrial engineering,” enclose it in quotes to limit the search to that phrase. Without quotes, you will get all content with “industrial” and “engineering” anywhere in the content with no explicit relationship implied.)

If you are reading this you probably know that, but many do not. In order to learn what people search for on their company intranet and how they type their search requests, I spend time reading search log files. I do this for several reasons:

  • To learn terminology searchers are using to guide taxonomy building choices
  • To see the way searches are formulated, and followed up
  • To inform design decisions about how to make searching easier
  • To see what is searched but not found to inform future content inclusion
  • To view the searcher’s next step when the results are zero or huge

wo results remain consistent: less than 1% of the searchers place a phrase inside quotations, even when there are multiple words; word are often truncated but do not include a truncation symbol (usually an asterisk, “*”). Both reveal a probable lack of search conventions understanding, a search literacy problem. Here are a couple of possible solutions:

  • Put into place better help and training mechanisms to help the lost find their way,

OR

  • Remove the legacy practice of forcing command language type symbols on searchers for the most common search requests

Placing punctuation around a search string is a holdover from 30 years ago when searching was done using a command language. Since only a limited number of people ever knew this syntactical format, why does it persist as the default for a phrase search for Web-based search engines?

The solution of providing a better help page and getting people to actually use it is a harder proposition. This one from McGraw-Hill for BusinessWeek Online is pretty simple with just seven tips but who reads it? I expect very few, although it could dramatically improve their search results. http://search.businessweek.com/advanced.jsp.

If you are trying to improve the search experience for your intranet, there are two resources to consult for content usability on all fronts, not just search: useit.com, Jakob Nielsen’s Website and Jared Spool’s UIEtips, User Interface Engineering’s free email newsletter. In the meantime, think about whether you need to demand more core search usability or tunable default options from vendors, or whether better interface design could guide searchers to better results.

Adobe Announces Adobe Creative Suite 3

Adobe Systems Incorporated (Nasdaq:ADBE) announced the Adobe Creative Suite 3 product line. Adobe’s new Creative Suite 3 line-up unites Adobe and Macromedia products to provide designers and developers with options for all facets of print, web, mobile, interactive, film, and video production. There are six all-new configurations of Adobe Creative Suite 3. These include, Creative Suite 3 Design Premium and Design Standard editions; Creative Suite 3 Web Premium and Web Standard editions; and Creative Suite 3 Production Premium; and, Creative Suite Master Collection which combines 12 of Adobe’s new design and development applications in a single box. The majority of Adobe Creative Suite 3 editions will be available as Universal applications for both PowerPC and Intel-based Macs and support Microsoft Windows XP and Windows Vista. Customers will experience increased levels of performance and speed running Creative Suite 3 natively on Intel-based Macintosh systems and the latest Windows hardware. Customers can choose from six all-new suites or full version upgrades of 13 stand-alone applications, including Photoshop CS3, Photoshop CS3 Extended, InDesign CS3, Illustrator CS3, Flash CS3 Professional, Dreamweaver CS3, Adobe Premiere Pro CS3, and After Effects CS3. Each edition of Adobe Creative Suite 3 integrates different configurations of Adobe’s creative products: Adobe Creative Suite 3 Design Premium delivers an essential toolkit for print, web, interactive and mobile design while Adobe Creative Suite 3 Design Standard focuses on professional print design and production. Adobe Creative Suite 3 Web Premium combines the web design and development tools and Adobe Creative Suite 3 Web Standard serves the professional web developer. Adobe Creative Suite 3 Production Premium is a post-production solution for video professionals. Lastly, Adobe Creative Suite 3 Master Collection combines 12 new creative applications in one box, enabling customers to design across all media – print, web, interactive, mobile, video and film. Creative Suite 3 Design Premium and Standard, and Creative Suite 3 Web Premium and Standard will begin shipping in April 2007. Creative Suite 3 Production Premium and Creative Suite 3 Master Collection for Mac OS X on Intel-based systems and for Microsoft Windows XP and Windows Vista platforms will begin shipping worldwide in the third quarter of 2007. Estimated street price for the Creative Suite 3 Design Premium is US$1799, US$1599 for Creative Suite 3 Web Premium, US$1699 for Creative Suite 3 Production Premium, and US$2499 for Creative Suite 3 Master Collection. There are upgrade paths available for customers. http://www.adobe.com

Public Alpha of Apollo Debuts on Adobe Labs

Adobe Systems Incorporated (Nasdaq: ADBE) announced that the first public alpha version of Apollo is now available for developers on Adobe Labs. Apollo is the code name for a cross-operating system application runtime that allows web developers to leverage their existing skills in HTML, JavaScript and Ajax, as well as Adobe Flash and Adobe Flex software to build and deploy rich Internet applications (RIAs) on the desktop. Apollo provides people with direct access to Internet applications built with HTML, JavaScript, Flash and PDF without the need to open a browser, offering more reliable interaction with content. With Apollo, people can launch applications directly from their desktops and interact with them offline. When a network connection is available, newly created or changed content can synchronize. The first version of Apollo for developers includes a free SDK that provides a set of command line tools for developing and working with Apollo applications. Web developers can use the Integrated Development Environment (IDE) of their choice, including Adobe tools such as Eclipse-based Flex Builder, Flash, and Dreamweaver to build Apollo applications. The alpha version of the Apollo application runtime, required to run Apollo applications, and the Apollo SDK are available immediately as free downloads from Adobe Labs. The Apollo SDK is available in English. The Apollo runtime and SDK are offered for both Windows and Macintosh operating systems, and future versions will be available for Linux. http://www.adobe.com/go/apollo

OASIS Updates ODF to Version 1.1

OASIS announced that its members have approved version 1.1 of the Open Document Format for Office Applications (OpenDocument) as an OASIS Standard, a status that signifies the highest level of ratification. The result of a collaboration between advocacy groups for the disabled and open source and commercial software vendors, this new version of the standard provides key accessibility enhancements to ensure that the OpenDocument format (ODF) addresses the needs of people with disabilities. OpenDocument 1.1 supports users who have low or no vision or who suffer from cognitive impairments. The standard not only provides short alternative descriptive text for document elements such as hyperlinks, drawing objects and image map hot spots, it also offers lengthy descriptions for the same objects should additional help be needed. Other OpenDocument accessibility features include the preservation of structural semantics imported from other file formats, such as headings in tables, and associations between drawings and their captions. The new version of OpenDocument reflects the work of the OASIS OpenDocument Accessibility Subcommittee, which is made up of accessibility experts from IBM, the Institute for Community Inclusion (ICI), RNIB, Sun Microsystems, and others. The Subcommittee’s recommendations were incorporated into the OpenDocument specification by members of the OASIS OpenDocument Technical Committee, which includes representatives from Adobe Systems, IBM, Intel, Novell, Sun Microsystems, and others. http://www.oasis-open.org/committees/office/, http://www.oasis-open.org

wikiCalc goes 1.0!

Dan Bricklin’s Software Garden announced the release of wikicalc 1.0. In Dan’s words: “After over a year and a half of work (part-time), I’m finally releasing the wikiCalc web authoring system as a “1.0” product. This means it has a pretty complete set of features for producing the quality output for which it was designed, has been relatively stable for a period of time, and has a reasonable amount of documentation. People who have held off testing or using the product until this point should now start taking a look. This is the code that will be the starting point for the SocialCalc project. You’ll find the new documentation, and a link to the downloads, on the new wikiCalc Product Home Page. This new documentation includes a “Features” page giving an overview of the product, a news page with an RSS feed, an “If you are new to wikiCalc…” page, and more. The documentation on the website is much more extensive than before. There are separate pages with details about setting up “Edit This Page”, “Live Viewing”, and other technical topics. The product Help files are reproduced, too. It is written from the point of view that many users will be setting up remote-access to hosted versions of wikiCalc. I designed it to be localizable into other languages, and reportedly Russian and Polish are far along, with more on the way including German, Italian, and Japanese. (I used Zbigniew Lukasiak’s rather complete Polish translation to test a lot of the localization code and catch bugs.) One person has written code for parsing and searching the edit log audit trail that wikiCalc keeps. As I fire up the Open Source project with the Socialtext people I’ll include places to post and keep track of these things.”

“There are companies in addition to Socialtext considering providing hosted services based upon wikiCalc. One that sprung up on its own is on the iWoorx website. iWoorx adapted the wikiCalc code to create a portal targeted at business users who use spreadsheets and email daily for exchanging simpler spreadsheets. They added more advanced user administration, cool graphing capabilities, and a “test drive” capability. They let users subscribe to some preconfigured collaborative spreadsheet pages designed for coordinating globally sourced consumer products. You can try their “test drives” without signing up. They are meant as an educational tool to introduce regular business people to the “wiki-ness” of wikiCalc in a portal environment. Seeing wikiCalc integrated with animated Flash graphs (in their “Live ChartLinx” test drive) is really cool and is just the type of thing I was hoping to see from others who took advantage of the open nature of wikiCalc. I’m not involved in the iWoorx project and it makes me feel great to see what others are doing all on their own with my creation. With all of the excitement around the experimentation with products and services lumped under the term “Web 2.0” it’s time for a web spreadsheet engine that is open to all around which to innovate. I chose Perl for the implementation because it is accessible to a wide range of programmers with a wide range of abilities and is easy to get running on almost any system. … There are many important features to be added and many people to bring into the project so that it can flourish. I intend to continue devoting a lot of time to this product. Here’s what will happen next: As I wrote back last June, Socialtext is going to integrate wikiCalc functionality into their wiki system and provide hosting and support to those that want it. They are also funding an open source project around the wikiCalc code so that I can move the product forward as part of a community. This wikiCalc 1.0 code will form the base release to start what Socialtext is calling the SocialCalc project. While the Software Garden release of wikiCalc is covered under the GPL 2.0 license, Software Garden is the author of the entire wikiCalc product and owner of the copyright. There have been no “contributions”. This will change with the SocialCalc codebase. That code will be developed much more in the open and will accept contributions from others (subject to my approval for now) who will hold the copyright to their contributions. My development work on new features will be going into SocialCalc, and Socialtext will be providing a lot of developer time, too, so that is where the future action will be. SocialCalc will be released under a Socialtext Public License that, being based on the Mozilla Public License 1.1, may be more appropriate for some companies who have issues with the GPL. (For users that want code covered under the GPL, this wikiCalc version 1.0 will always be available under that license.) There will be more news about SocialCalc at a later time.” http://danbricklin.com/log/2007_01_25.htm#wikicalc1_0

SoftCare Releases SoftCare K4 Version 5.7

Version 5.7 of publishing solution SoftCare K4 is now available. The new release of the editorial system includes several enhancements that can help publishers using Adobe InDesign and InCopy. Among these features are a new scripting interface for automating customer-specific processes, and the optional K4 Web Editor 2.0, which allows users to write and edit articles to fit in a Web browser and offers more flexibility in including the staff in the work processes. An improvement in Version 5.7 enables functions specific to the K4 system to be accessed automatically through scripts (JavaScript, AppleScript or Visual Basic), improving speed and productivity by allowing users to automate certain tasks within the editorial workflow. K4 Web Editor 2.0 lets users write, edit and copyfit Adobe InCopy articles in K4 from any computer with nothing more than a Web browser and an Internet connection. Articles checked out with K4 Web Editor are locked in the database; check-in from Web Editor unlocks the file and updates the database. Accurate representations of K4 articles, complete with styling, font mapping and layout geometry, are generated by Adobe InDesign Server and made available via a password-protected browser interface. It also allows users to work offline. Other improvements include the new easy query mode which allows quick searching for document names, and improved accessibility with larger fonts in the job lists. SoftCare K4 version 5.7 is available from K4 System Integrators worldwide. Customers using K4 version 5.0 or higher with valid maintenance agreements are eligible for a free upgrade. The K4 Web Editor is available for purchase as an option for K4 5.6 and 5.7 installations. K4 supports Mac OS X and Windows clients in mixed-platform environments. The server software is available for Mac OS X, Windows, Sun Solaris and Linux. http://www.softcare.de

Online Help and Customer Experience

Although I have been out of the technical writing trenches for some time now, I enjoy staying in touch with my techdoc buddies and keeping up with the hot issues. One I remember well is the challenges in the early 90’s of single-sourcing documentation for print, electronic, and context-sensitive online help delivery.

Apparently it’s still hot, despite the release of RoboHelp6 from Adobe, a tool I remember quite well. This is the first product update Adobe has released since the company bought Macromedia over a year ago. Product reviewers generally agree that Adobe beat the estimated delivery date by months, although there is some confusion over dueling version numbers according to my friend Char James-Tanny over at helpstuff.com. Still, an early release is a good sign in terms of a company’s current and future commitment to a product.

On the other hand, product reviewers also seem to agree that “XML does not seem to be a priority.” Hmmm. That certainly does not bode well for champions of single-sourcing for multi-channel publishing (although the new version automates hyperlinked PDF creation.) Even more interesting are the passionate responses to an unfavorable monkeyPi product review, including an extremely detailed rebuttal from Rick Stone, Adobe’s Community Expert for the product (although he’s not an employee…)

Without claiming to have reviewed the product, what I find most interesting is Adobe’s focus on source and version control, team collaboration and workflow, and the usage tracking capabilities of RoboHelp Server6. Adobe describes this latter feature as the ability to identify frequently-viewed content, view usage statistics, and uncover search trends.

As we’ve discussed in numerous posts, relevant content and customer experience are intrinsically related, whether the project is Web site design, localization efforts, or yes, even online help development. (Part 2 of our series on this subject, Small Content Changes, Big Impact takes place on Thursday February 1st.) Assuming RoboHelp Server6 provides the insight into the online help user experience it claims, its value to techdoc departments striving for more “upstream impact” in their organization could be quite significant.

« Older posts Newer posts »

© 2025 The Gilbane Advisor

Theme by Anders NorenUp ↑