Category Archives: Video

What’s up with SUMO – Mar. 11

Big things this week

What’s up with SUMO – Mar. 4

Big things this week

What’s up with SUMO – Feb. 25

Big things this week

What’s up with SUMO – Feb. 11

Big things this week

What’s up with SUMO – Feb. 4

Big things this week

Writing and updating articles

Planet Mozilla viewers – you can watch this video on YouTube.

This is a followup to my post, “What should we document?” and is part of our technical writing program for SUMO.

Now that we have our list of what needs to be documented, it’s time to get started. All of the documentation that I talk about in the video can be accessed from this article – Improve the Knowledge Base.

If you have suggestions for making this particular workshop better, please reply to this thread in our knowledge base forum.

What’s up with SUMO – Jan. 28

Big things this week

  • Notes and video from this SUMO meeting.
  • Thanks to everyone who participated in Help Document day: satdav, feer56, wbamberg, alicewyman, scoobidiver, expressive, Tonnes, ideato, adampeeblewrites, verdi, rolandtanglao, iNerd and hermina_condei.
  • This Thursday is SUMO day. Last time we answered 93% of the questions.
  • Next SUMO meeting – Monday, Feb. 4th (call in details & meeting notes) at 10:00 am PST. Please add your comments, questions and updates to the wiki. You can also participate in #sumo during the meeting. We’re going to record and post a video of the meeting.

What should we document?

Planet Mozilla viewers – you can watch this video on YouTube.

This is a followup to my post on figuring out what’s new in Firefox and is part of our technical writing program for SUMO.

Once we’ve figured out what changes will be visible to users, we have to figure out what articles need to be written or updated. Here’s how I figure that out:

  • First I determine what changes need to be documented. Not every change needs to be documented (or at least, documented on SUMO).
    • Here are some things we generally DON’T document:
      • Developer tools
      • Changes to our support for web standards (like unprefixing a new CSS element).
      • Minor visual changes. In the past we’ve made the outline of buttons more or less prominent for example without updating our documentation.
      • “Under the hood” changes like speed improvements and new javascript engines.
    • Here are things we DO document:
      • New features like Facebook Messenger or Firefox Reset.
      • Changes to existing features. Our site supports showing different sets of instructions to different operating systems and different versions of Firefox. In this way we can customize the article to match what people are using. Look at the Startup, home page and download settings article and switch the controls at the top from Firefox 18 to Firefox 17 and you will see that there is a section about add-on for Firefox 17 that isn’t there for Firefox 18.
      • Problems or questions we anticipate people will have. For example, Click to play blocklisting or ending support for Firefox 3.6.
  • Next I look at each change that needs to be documented and decide if it needs a new article or just an update to an existing article. Generally, if we already have an article on a topic, we probably just need to update it. New features or new problems generally require new articles. Occasionally it’s a little more complicated and we’ll have to discuss the best course of action.

If you have suggestions for making this particular workshop better, please reply to this thread in our knowledge base forum.

Figuring out what’s new in Firefox

Planet Mozilla viewers – you can watch this video on YouTube.

Rosana and I have been working to build a technical writing program for SUMO. We now have a group of four participants so I posted the first workshop – researching what’s new in Firefox. Here are links to the resources I talk about in the video:

If you have suggestions for making this particular workshop better, please reply to this thread in our knowledge base forum.