Just Write Click

Technical writing with Continuous Integration and docs-as-code

  • JustWriteClick
  • Contact
  • Books by Anne Gentle
  • Introducing Docs Like Code
You are here: Home / blogging / The Data Transaction

January 28, 2011 by annegentle

The Data Transaction

Several times lately I’ve caught myself over-thinking just a bit while typing online. For example, just this week I typed in a tidbit of info, an answer to a question, as a reply on a friend’s status update in Facebook, only to delete it without clicking the Reply button. Once it was in response to a post about countertop materials. Another time it was a query about the best Mac money management software as a replacement for MS Money. Both times, I checked myself because I realized  that I didn’t want Facebook to have knowledge about my opinions or preferences! Now, those that know me would say that I’m normally very open and giving with information online. I love sharing my experiences. But lately I get the willies when I’m on the Facebook site and think of the enormous amounts of data they have about me.

You may scoff at such a realization – especially since I’ve been blogging for five years. But somehow my blog is different. I own the archives, I know how to take down posts, and though they are likely forever archived on the ‘net somewhere, I feel a little more control over their availability. With Facebook, I have no control over their storage or retrieval of my opinions.

Funny thing is, what I’ll often do if I still want to give my friends a bit of info or advice, I’ll hop over to… wait for it… GMail. Why do I trust Google with these tiny tidbits of information about myself and not Facebook? I’m not sure I know the answer yet, but I think about it more and more lately.

Affecting Online Help Statistics

Now, with my blog, I nearly always bring my thinking around to, how does this affect online help? I recently presented at the WebWorks RoundUp here in Austin, and was excited to hear about their new product, WebWorks Reverb. But one audience member asked a great question during my talk about web analytics. “How will data collection be affected if Congress passes a law that regulates how much information can be collected from a browser?” It’s a great question. In fact, just this week, browser maintainers Mozilla (Firefox) and Google (Chrome) have made privacy plugins available that give users the ability to select websites where they do not want to be tracked – using a header indicator, not by blocking cookies or scripts.

Here’s my take on where we stand today as we collect information about our online help and user assistance sites.

Thing is, you can already protect yourself online while browsing by installing plug-ins that refuse cookies, that limit tracing of personal information and identity, but they’re kind of a pain. And you have to understand the whole concept of what’s being collected and draw your own lines. Certainly, depending on the product you’re documenting, the percentage of people with high protection levels on their browser will be higher or lower. Government or regulated industries may already lock their employee’s browsers down tight, preventing data collection while they browse. In open source communities, I believe there’s a healthy disdain for data collection and a heightened awareness of what’s going on under the browser’s hood. It’s possible I’m only tracking 90% of my readers, or fewer. But I think that generally, readers of online help sites are willing to inform us of their searches, their time spent on site, if it helps us improve the content. Sarah Maddox’s post shows that Atlassian and its customers get great value from their online user documentation. As we implement more and more conversational content, it’s apparent that readers want to tell us what’s working well and what’s not. I’m heading to O’Reilly Strata next week to learn more about big data, telling data stories, and Twitter data analytics. I hope to learn more about data applications for technical communication.

What do you think? Are you more aware of the data you’re giving away about yourself? Are the trade-offs worth the data transaction?

Related

Filed Under: blogging, social media, techpubs, tools, writing Tagged With: analytics, browser, collection, data, open, privacy, techcomm

More reading

Bubble graph showing sources of developer support data

I’ve been thinking a lot about developer support at Cisco recently, especially for the way the world works today with multiple cloud providers. This post is a re-publish of my talk from over five years ago, but the techniques and tools for listening and helping others are still true today. At Rackspace, we watched several […]

Cisco DevNet is our developer program for outreach, education, and tools for developers at Cisco. From the beginning, the team has had a vision for how to run a developer program. Customers are first, and the team implements what Cisco customers need for automation, configuration, and deployment of our various offerings. Plus, the DevNet team […]

I had a great talk with Ellis Pratt of Cherryleaf Technical Writing consulting last week. Here are the show notes, full of links to all the topics we covered. Podcasts are great fun to listen to and participate in, if a bit nerve-wracking to think on your feet and make sure you answer questions succinctly […]

At the beginning of this year, I worked hard to summarize my thoughts on API documentation, continuous publishing, and technical accuracy for developer documentation. The result is an article on InfoQ.com, edited by Deepak Nadig, who also was forward-thinking in having me speak to a few teams at Intuit about API documentation coupled with code. Always […]

Recently on Just Write Click

  • A Flight of Static Site Generators: Sampling the Best for Documentation
  • Try a GPT about “Docs Like Code” to ask questions
  • Discipline and Diplomacy: Docs in the Open
  • Let’s Find Out: When Do Static Site Generators Do Rendering?
  • GitHub for Managing Tech Docs

Just Write Click in your Inbox

Enter your email address to subscribe to Just Write Click and receive notifications of new posts by email.

Read More

  • Privacy Policy
  • About Anne Gentle, developer experience expert
  • Books by Anne Gentle
    • Conversation and Community
    • Docs Like Code, a Book for Developers and Tech Writers
  • Woman in Tech Speaker Profile
  • Contact

Books

  • JustWriteClick
  • Contact
  • Books by Anne Gentle
  • Introducing Docs Like Code

Copyright © 2025 · WordPress · Log in