A directory of resources inthe field of technical communication.

Just Write Click

36 found. Page 1 of 2.

About this Site | Advanced Search | Localization | Site Maps
 

1 2  NEXT PAGE »

 

1.
#37192

Advocate for Community Documentation

Let’s say that the most driven and driving developer on your team, who also happens to be a popular blogger, comes to you and asks why your end-user documentation doesn’t allow comments or ratings. Rather than stammering something about Wikipedia’s latest scandal, or reaching for imperfect responses that sound like lame excuses, do your homework and learn best practices from others who are implementing social web content that is conversational or based on community goals.

Gentle, Anne. Just Write Click (2010). Articles>Documentation>Wikis>Social Networking

2.
#36022

Agile Across the Enterprise

One of the Agile Manifesto’s basic balance equations is valuing working software over comprehensive documentation. This line of the Agile manifesto can be confusing to some supporting roles in an Agile development enterprise. As technical support staff, trainers, and content creators, what are we doing to fit into this Agile methodology, and what’s working well? Let’s explore some old habits that need to die, and some new rituals to fill that space.

Gentle, Anne. Just Write Click (2009). Articles>Collaboration>Agile

3.
#34576

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

4.
#36017

Can DITA Train Writers? Or Does it Require Too Much Programming?

Because writers have to immediately place the information they want to record into one of these three types of information, they are being trained on how to write in a task-oriented, performance-based manner, via DITA. I am especially interested in this “training” for wiki authors and talked about the idea at our recent presentation.

Gentle, Anne. Just Write Click (2009). Articles>Education>Technical Writing>DITA

5.
#35288

Choosing a License for Sharing Documentation Content

What issues and legalities do we as Technical Communicators or Wiki Administrators need to be aware of as we move towards collaborative authoring projects and so forth, especially when documenting open source software?

Gentle, Anne. Just Write Click (2009). Articles>Documentation>Intellectual Property>Open Source

6.
#36092

Clearing the Air on Cloud

Consumer users have been reaping the benefits of the utility model in cloud computing for years — at the application as a service level. It is developers and IT who are using cloud computing in a transformative way now. IaaS and PaaS allows them to develop, test, deploy and run apps that can scale on enterprise grade technology, all without having to pay the capital expense for the underlying infrastructure. This is creating a new cloud economy and truly represents the democratization of computing.

Gentle, Anne. Just Write Click (2010). Articles>Technology>Collaboration>Cloud Computing

7.
#35933

Collaborative Authoring: Tools and Costs

I’ve been working on some collaborative authoring scenarios for our Agile teams – we’re going from 5 people to 47 people in total who could author external or internal documentation within our two week sprints. Turns out, we likely represent some trends in the enterprise.

Gentle, Anne. Just Write Click (2009). Articles>Content Management>Writing>Collaboration

8.
#35828

Comparing RSS Feeds to Social Networks

Jakob Nielson and his research group, Nielsen Norman Group, have done it again – letting us know how users are actively perceiving and using social software for different business tasks. This research is important as the social web evolves so that we, as web content creators, know the best ways to present and offer different types of information, especially for corporate sites.

Gentle, Anne. Just Write Click (2009). Articles>User Experience>Social Networking>RSS

9.
#35525

Consistency and Community-Generated Content

I’ve been collecting examples of wildly inconsistent writing lately. I’m not sure why these have stuck out to me, but when I think of book sprints and community writing events, consistency is an important, though sometimes difficult, goal and outcome.

Gentle, Anne and Janet Swisher. Just Write Click (2009). Articles>Documentation>Style Guides>Wikis

10.
#35297

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

11.
#36021

Content Strategy and Web Writing

Boy, it must be getting harder and harder to be a web writer. I’m reading Content Strategy for the Web, and the web writer job description is intimidating! The quote that stuck with me talks about the Web Writers Real Job: problem solvers who write well.

Gentle, Anne. Just Write Click (2009). Articles>Web Design>Writing>Content Strategy

12.
#35192

Corporate Collaborative Authoring

The idea of a Book Sprint is that you can get lots of documentation written in a focused amount of time with the right team and some amount of content already in place. Gathering people in the same room when possible is extremely helpful and motivating as well.

Gentle, Anne. Just Write Click (2009). Articles>Collaboration>Agile>Documentation

13.
#32090

Darwin Information Typing Architecture (DITA) Reading List

Here’s a reading list for DITA materials when you’re just getting started. I’ve been fielding some questions via email and IM about DITA lately, and pulled this blog post out of my drafts. I hope it’s helpful.

Gentle, Anne. Just Write Click (2008). Articles>Bibliographies>XML>DITA

14.
#38169

Dilbert Versus Godzilla: How to Prepare Yourself to Deal with Monsters in the Workplace

As editors, it is good to remember the following points to discern and work through conflict situations.

Van Brink, Mary R. Just Write Click (2011). Presentations>Collaboration

15.
#36617

DITA for Publishers with Eliot Kimber

DITA enables iterative design and development – when you come across something more sophisticated than the “norm” you just keep adding features – and interchange is always ensured.

Gentle, Anne. Just Write Click (2010). Articles>Interviews>Publishing>DITA

16.
#37265

Documenting Open Source Software

I love reading different community perceptions of both FLOSS Manuals, where we write open docs for open software. I’m also lurking on mailing lists and forums where open source projects are figuring out documentation needs for their users. Forgive me if I ramble a bit, but I’ve been thinking about these concepts lately while discussing them with other writers.

Gentle, Anne. Just Write Click (2010). Articles>Documentation>Technical Writing>Open Source

17.
#36353

Email Feedback Mechanisms for Online Help

Email has become a universal conversation mechanism for business to business notification, customer to business communication, you name it. If you’re not doing so already, you can add email links so that readers can send emailed feedback to your technical documentation team. With advanced mailto markup you can automatically enter a subject line, indicate who the email will go to, as well as enter courtesy copies and blind courtesy copies to additional people. Your inbox should not be overwhelmed with feedback emails, but a link should give customers the feeling that their comments are collected and concerns addressed. This is conversational documentation at its simplest.

Gentle, Anne. Just Write Click (2010). Articles>Documentation>Help>Email

18.
#36020

Focused Communities

Community purposes vary as widely as the people who comprise a community. You know that participants on Twitter Moms are not the same people as those hanging out on Dad Labs community, instinctively. But what are some of the factors that differentiate communities?

Gentle, Anne. Just Write Click (2009). Articles>Social Networking>Community Building>Online

19.
#32091

Getting Started with DITA

A brief overview for a couple of fellow Austin writers who have asked me recently how and where to get started with DITA.

Gentle, Anne. Just Write Click (2007). Articles>Information Design>XML>DITA

20.
#37420

Going into Listening Phase

I’m going into a listening phase for a client, where I observe their customers and partners habits online. I thought I’d write up some of my techniques.

Gentle, Anne. Just Write Click (2010). Articles>Interviewing>Advice

21.
#36600

I Am Who I Am

James is a pen name for a woman freelance writer, who writes the popular blog Men with Pens. Merely representing herself as a man made a real difference in her career trajectory. It made me wonder if I’d have 10 times the subscribers to my blog if I had started in 2005 as Tom Gentle. It really did.

Gentle, Anne. Just Write Click (2010). Articles>Blogging>Ethnographies>Gender

22.
#37033

Interview Techniques for Users

I had a great talk the other night with a classmate of mine from graduate school, who focused on usability and now works on a web application development team as their user experience designer. He’s Tim Keirnan, and I asked him to explain some of his interview techniques that he uses for his Design Critique podcast. I also got great snippets about his user interviews.

Gentle, Anne. Just Write Click (2010). Articles>User Centered Design>Podcasting>Interviewing

23.
#29360

Just Write Click

A blog about technical writing, information architecture, topic authoring, social media, and other technologies that catch Anne Gentle's eye.

Gentle, Anne. Just Write Click. Resources>Writing>Technical Writing>Blogs

24.
#36238

Last Sprint, First Step

This week is my last Agile sprint for a while, but I think I’ll adopt some Agile principles and apply them to my new work lifestyle as an advisor for LugIron and a contractor for Informatica here in Austin.

Gentle, Anne. Just Write Click (2010). Articles>Documentation>Technical Writing>Agile

25.
#36885

Social Media, Conversation, and Writing Style

What are some pointers for developing a style guide for writing on the social web or for certain social media? I discuss style guidance at length in chapter 7 in my book, which is titled Finding Your Voice. In fact, I read from chapter 7 for my book reading at South By Southwest Interactive last week! Definitely finding my voice on the couch on stage.

Gentle, Anne. Just Write Click (2010). Articles>Writing>Style Guides>Social Networking

 
 NEXT PAGE »

 

Follow us on: TwitterFacebookRSSPost about us on: TwitterFacebookDeliciousRSSStumbleUpon