Git Resources

Git, though remarkably handy and powerful, is also remarkably hard to use sometimes. Though you can learn the basics easily enough, it can be really tough to dig yourself out of certain corners if you don’t understand what’s going on under the covers. This page provides links to documents, how-tos, cheat sheets, tips, and tricks related to learning and using git.

37Signals (2009). Resources>Content Management>Graphic Design>Software

Control and Community: A Case Study of Enterprise Wiki Usage

There are a wide variety of uses for Wikis and a level of interest in using them that’s matched by an extensive range of Wiki software. Wikis introduce to the Internet a collaborative model that not only allows, but explicitly encourages, broad and open participation. The idea that anyone can contribute reflects an assumption that both content quantity and quality will arise out of the ‘wisdom of the crowd.’

Clarke, Matthew C. Boxes and Arrows (2009). Articles>Web Design>Content Management>Wikis

A Call to Action for Web Managers: Blow the Whistle

We still had a huge, unruly Web site. It just had different graphics, a better-named Web team and more people shoveling on content and applications. Finally, out of desperation, we decided to try a new-fangled thing called a Web content management system.

Welchman, Lisa. WelchmanPierpoint (2009). Articles>Web Design>Content Management>Case Studies

My Apache WebDAV/Windows Nightmare

The goal was to use Subversion (SVN) as a poor man's CMS, and take advantage of great PC-based editors like DreamWeaver (for HTML) and XMetaL (for DITA). Eventually, we could add pre-commit checks and utilities to give us some of the advanced functionality we'd really like--like link management and metadata change management--but in the meantime we could do everything manually to get by. All we had to do was install Subversion and enable the WebDAV interface in Apache. But many hurdles later, I'm exhausted from jumping over them. Every one requires me to look through 20 web pages in search of a solution, and each time I surmount one obstacle, it's only to find a new one standing in my way.

Sun Microsystems (2007). Articles>Web Design>Content Management>Case Studies

The Value of Semantic Tags

So what's wrong with using <b>, <i>, and <tt>, anyway? What's so useful about identifying things as menu items, APIs, or filenames? Here's the list of reasons that surfaced at the recent 2008 DITA/CMS Conference. What are your thoughts?

Armstrong, Eric. Sun Microsystems (2008). Articles>Web Design>Content Management>Semantic

Are Structured Authoring and Wiki Opposing Forces?

There are two camps in technical documentation. There’s the “quick web” folks who connect easily and author easily, and then there’s the “structured quality” camp that requires more thoughtful testing and time spent on task analysis and information architecture.

Gentle, Anne. Just Write Click (2007). Articles>Content Management>Information Design>Wikis

Getting a Handle on Your Content Types

“Content types” are among the least understood, and yet most potent, aspects of user experience and web design. Most people encounter them for the first time when implementing a grand-scale content management system (CMS) because you have to define content types before building templates for each kind of content you’re going to publish. Because they associate content types so closely with CMS, some make the mistake of equating content strategy with content management. They’re not the same thing, though they are certainly related. Your content strategy specifies the content types that will then be modeled for your CMS.

Content Strategy Noob (2009). Articles>Content Management>Information Design>Content Strategy

Be Known For Your Content, Not Your Name!

Be known for your content first, for your name second. I can’t bear to hear anyone say one more time that “content is king,” but the truth is simple, if painful.

Content Strategy Noob (2009). Articles>Content Management>Web Design>Writing

The Illusion of SEO vs. the Reality of Great Content

SEO techniques will increase your search rankings and SEM will get you traffic on the top search engines. But a boatload of quality content will also accomplish these things and prepare you for the more contextual future of search.

Tipping Point Labs (2009). Articles>Web Design>Content Management>Search Engine Optimization

Technical Communication Trends and Ideas

Technical Communication continues to change as we find new ways to meet the needs of our audiences. I have attended several conferences recently and discussed several of the latest trends with other technical communicators. This article provides a quick list of several of these trends and ideas.

Mueller, Paul. Answers for All (2009). Articles>TC>Content Management>Information Design

さまざまな利用を想定して書く

オンラインコンテンツは、文脈とは無関係にユーザーの目にとまることが多い。本来想定された目的とは違う目的で読まれることもよくある。そうした目的を全部予測することはできないが、テキストのさまざまな利用を考慮することはできる。

Nielsen, Jakob. Usability.gr.jp (2009). (Japanese) Articles>Content Management>Writing>Information Design

Back-End Designs and the CMS Cycle of Disillusionment

Usually, the one thing missing from the planning of a WCM-driven web site is what's most likely to shoot the implementation in the foot: the functional design of the CMS back-end. The form and function of how the CMS will work, look and feel for the end-user of the system, not the visitor to the web site, is too often overlooked. This is odd: isn't the rationale for getting a CMS in the first place usually based on some kind of ROI in efficiency in actually producing the content and sites?

Bloem, Adriaan. CMSwatch (2009). Articles>Content Management>Information Design>Content Strategy

Moving from Web Management to Information Management: Four Things You Can Do Now

Web Managers must think globally (information) and act locally (Web) all the while trying to widen your universe and build the internal business relationships which will allow your organization to manage its information more holistically now or in the future.

Welchman, Lisa. WelchmanPierpoint (2009). Articles>Content Management>Content Strategy>Information Design

On Creation and Consumption

While the design of democracy is a wonderful thing, democratic design is less positive. We’ve heard over and over that “everyone is a designer,” and that through a combination of user-generated content, ubiquity of access, and new tools, design has finally made its way out of an ivory tower and into the grasp of the masses. What, exactly, have the masses gotten their grubby paws into? Can one truly claim to be a designer when they upload a picture to Facebook or remix a video for YouTube?

Kolko, Jon. Interactions (2009). Design>Content Management>Social Networking>Participatory Design

Converting to XML: Is it Always the Answer?

Although managing costs is important anytime, it is especially important in today's economic reality where budgets are shrinking drastically. Getting your money's worth as well as what you need to support your data should be a core factor of any data project. The two biggest cost factors are the type of conversion work you need done and how much of it you'll need. This article focuses on how your goals for your project relate to the output format you choose, and how that format impacts costs. While some outputs, like XML, provide higher capabilities, they also cost more to create.

Gross, Mark. Data Conversion Laboratory (2009). Articles>Content Management>Information Design>XML

Alternatives to XML: Keeping Down your Document Conversion Costs

While I'm a big fan of XML for many purposes, it's a misconception that it's the single best solution in every scenario, and it's worthwhile to consider the alternatives in situations where the benefits of XML are not necessary. In this article, I discuss alternatives to XML, SGML, and HTML that might be suitable when budgets are more limited. While XML is perfect for highly coded information, other options can work well for many kinds of information. Markup languages are at the high end of the cost spectrum, so if you don't need the benefits they provide, you certainly should consider the alternatives discussed below.

Gross, Mark. Data Conversion Laboratory (2009). Articles>Content Management>Information Design>XML

The Case for Content Strategy—Motown Style

If content strategy isn’t in the current budget, though, how do you convince your client to add money for it? Your client might already realize content strategy can help create measurable ROI. If they don’t, help them understand. After all, relevant and informative content is what their audience wants; content strategy assesses the content they have and creates a plan for what they need and how they’ll get it.

Bloomstein, Margot. List Apart, A (2009). Articles>Web Design>Content Management>Content Strategy

WebWorks ePublisher for Converting Documents to Confluence Wiki

Over the past couple of weeks I’ve had the chance to experiment with WebWorks ePublisher, a set of tools that converts documents from Word, FrameMaker and DITA XML to a number of different output formats. One of those output formats is Confluence wiki. It’s been very interesting, so I thought I’d blog about it and see if anyone else wants to give it a go as well.

Maddox, Sarah. ffeathers (2009). Articles>Web Design>Content Management>Wikis

Content Curation: A Manifesto

A Content Curator is someone who continually finds, groups, organizes and shares the best and most relevant content on a specific issue online. I think that professional writers and technical writers should consider a move towards this role. We already search for and find the best content, sift through loads of content, discard poor content, and publish the most worthy content whenever a software release goes out. This description also sounds like something a content strategist would do as part of their analysis of the content.

Gentle, Anne. Just Write Click (2009). Articles>Content Management>Information Design>Technical Writing

Manifesto For The Content Curator: The Next Big Social Media Job Of The Future?

A Content Curator is someone who continually finds, groups, organizes and shares the best and most relevant content on a specific issue online. The most important component of this job is the word "continually." In the real time world of the Internet, this is critical. In an attempt to offer more of a vision for someone who might fill this role, here is my crack at a short manifesto for someone who might take on this job.

Bhargava, Rohit. Social Media Today (2009). Articles>Content Management>Content Strategy>Information Design

What is Intelligent Content? And Why Won’t Scott Abel Shut Up About It?

Intelligent content is content which is not limited to one purpose, technology or output. It’s content that is structurally rich and semantically aware, and is therefore discoverable, reusable, reconfigurable and adaptable. It’s content that helps you and your customers get the job done, often automatically.

Abel, Scott. Content Wrangler, The (2009). Articles>Content Management>Information Design>XML

Just Put That In The Zip Code Field: The Ins and Outs of Content Modeling

How closely does the content in your CMS resemble the logical content you planned on? # Different systems have vastly different content modeling.

SlideShare (2009). Presentations>Content Management>Information Design

What Information Developers Can Learn from Software Developers 

The shift in information development from a narrative to a modular writing style reflects the established shift towards modularization of source code. What can information developers learn from software developers? What are the challenges and benefits of the modular approach?

Higgins, Paul. TC World (2009). Articles>Information Design>Content Management>Documentation

Wicked Problems and SharePoint: Rethinking the Approach 

SharePoint can neither create nor destroy organizational chaos, but does an excellent job of reflecting the level of organizational chaos that existed at the time of deployment. The “SharePoint paradox” and paths to SharePoint wickedness. The power of Issue Mapping and IBIS based collaboration. How to leverage the best of SharePoint and Issue Mapping.

Culmsee, Paul. SlideShare (2009). Presentations>Content Management>Information Design>Microsoft SharePoint

Get Smart With SharePoint Documents 

Given the pressures on firms to provide increased value at lower costs, it’s imperative that they find ways to reduce the costs of creating and managing documents and increase their value to clients and personnel. Microsoft SharePoint provides a range of features to make your firm’s documents “smarter,” from capturing rich metadata to automating workflows to intelligent search. As applied, these features can transform passive documents into active, reusable resources. In this article I’ll describe some of the ways that SharePoint can reduce the effort to create, manage and retrieve documents and increase their value, as smart documents, to both your firm and its clients.

Gerow, Mark. End User SharePoint (2009). Articles>Content Management>Information Design>Microsoft SharePoint