Testimonial – Words of wisdom on proposal writing

I appreciate the words of wisdom Jason shared in class about persevering and being open to all kinds of writing as a technical writer. Those words were valuable when I began my technical writing role as part of a sales team. It involves a lot of proposal writing, which walks a nice line between informative and persuasive writing. I’m using my strengths, but expanding the scope of my writing skills as well.

—Deborah Hazebroek,Technical Writing Student, BCIT
(now Technical Writer at ENBALA Power Networks Inc.)

Celebrate Canada Day! 15 uniquely Canadian words

How-Canuck

For many new students in BCIT’s Technical Writing Certificate program, I am the first instructor they meet. They usually show up slightly nervous about their writing with all its rules for grammar and style. Sensing their nervousness I’ve devised a fun game to get them to think about the English language and its many variants.

Canada is long in geography but short in history so the fact that our country sports uniquely Canadian English spelling variants is a point of pride among many Canadians. For Canada Day, test your Canadian-ness with these 15 spine-tinglingly unique Canadian spellings.

BC Renal Agency

Role: Technical Writer/Instructional Designer (2014–2016)

Need: Responsible for training clinical staff across several health authorities, BC Renal’s in-house software development department struggled to maintain the standards of its various training materials (online and print). Not only could users not find the information they needed, but trainers were never sure which versions of documents were last updated. The Training department (and by association, BC Renal) was having a crises of credibility.

Solution: Starting with a single 600-page user manual, I restructured the information to be more task based. By developing a system of key documents and sub documents, we could start to customize documentation to training needs (without creating duplicate information).

I then tackled the document template, eliminating unused, unneeded styles, and establishing a style guide). With a single-sourced knowledge base content, we could ensure consistent IT documentation.

While working on the online LMS system, I implemented ADDIE training plans for instructor-led training (ILT) and computer-based training (CBT).

Finally, I assisted in developing a strategic approach to increase effectiveness of communication between IT content and healthcare audience.

Tools used:

  • PROMIS (in-house kidney care information system)
  • Microsoft Office (Word, Excel, PowerPoint…)
  • Doc-To-Help (webhelp authoring and publishing using Microsoft Word)
  • Jira (issue tracking product that allows bug tracking and agile project management)
  • Adobe Captivate (LMS authoring tool for creating elearning content such as software demonstrations according to SCORM standards)

Read testimonials about this position…

Growing Communities with Community Gardens

Type: Magazine article
Objective: Provide a balanced view of communities gardens
Purpose: Gain appreciation for community gardens 
Audience: Subscribers to digital magazine

 

Growing Communities with Community Gardens

by Jason Hall

Burrard and Davie – Now

Burrard and Davie – Then

It’s not magic. At street level it may look like magic, but community gardens are not the work of some cosmic Aquarian happening or even merely the work of avid gardeners. They are a carefully orchestrated balance between government, property owners, community advocates and, of course the citizenry you see toiling the soil. And therein, lies the beauty.

Take for example, the highly visible Davie Village Community Garden on the northwest corner of Davie and Burrard. A few short years ago when condo developments were sprouting on every corner of the city, Prima Properties (its property developers), wanted to cash in and redevelop the existing Shell gas station and mini mall into a new high rise condo tower, they were met with opposition from the West-End Residents’ Association and other area interest groups fearing that the character of the Village would be threatened.

This property, 1157 Burrard, falls in the cross hairs of many conflicting priorities. For example, nearby St. Paul’s hospital has an influence on the property and how it’s developed, but doesn’t own it. So when Prima properties applied for a permit to develop the site as a mixed-use high-rise development, the city declined it.

Community Garden Forensics

Before there was Prima properties (community garden), there was Omni Group (community garden). Sounds ominous, doesn’t it? Omni Group owns property at Pacific and Seymour and rather than it lying fallow for the years it took for development to commence, Omni Group offered the land up for a temporary community garden. Thus was born, Seymour Community Garden.

Today, Seymour Community Garden is no more and it is remembered with some bitterness by its former gardeners who were given a scant two weeks to vacate the property before the backhoes arrived. According to Jon Lau, a member of Davie Village Community Garden Committee, “Rumours undermined the truth” and in fact, gardeners were told that they’d need to vacate any time between January and April, but as it happened, January was the month and this took many gardeners by surprise.

Jon sees the Seymour Garden, with which he was also involved, as a learning process on the path to the Davie Village Garden. “If not for Seymour Garden, Davie Village Garden couldn’t have taken place”, he explains even while admitting that “each garden has its own personality”. Jon is philosophical about the impermanent nature of these gardens, “I don’t look at it from the standpoint of longevity…I ask what can we do with the time we’ve got?”

Community Integration

Jon reflects that the single most common question from those visiting the Davie Village Community Gardens during the Olympics was, “How did you guys do this?” How it’s done is through community integration.

City Legislators

In midsummer 2003, Vancouver City Council approved a motion supporting the development of a “just and sustainable” food system for the City of Vancouver.

The intention was to develop a system in which food production, processing, distribution and consumption would be integrated to enhance the environmental, economic, social and nutritional health of a particular place. City Council formed the Food Policy Task Force and in 2007, unanimously adopted the Vancouver Food Charter, an ambitious vision based on five principles:

• Community Economic Development
• Ecological Health
• Social Justice
• Collaboration and participation
• Celebration

Encouraging community gardens also dovetails nicely with the city’s own Greener City Initiative, a mandate for Vancouver to become the greenest city in the world by 2020.

Property Developers

Most of the city’s community gardens are not on private land; they are on public lands such as parks and transportation corridors (most notably Arbutus Victory Garden, as its name suggests owes its longevity to its origins as a Victory Garden during the war). Community gardens developed on private land are naturally beholden to the property owners, but the property owners are incentivized by various regulatory bodies that provide tax exemptions for hosting the gardens.

Under the Prescribed Classes of Property Regulation, property owners can temporarily have their properties reclassified from Class 6 (business and other) to Class 8 (recreational property/non-profit organization), which can provide them with up to 70% on taxes. It’s easy to see their generosity in putting up the land, including the garden infrastructure, in exchange for a 70% cut from their yearly (in the case of 1152 Burrard – $345,000) tax bill as merely a way of skirting property taxes.

Still, the property could remain fenced off and ugly as was the case with the property at Davie and Howe, which remained a hole in the ground for the better part of a decade. Opting to host a community garden on private property is not without its headaches. Take for example the South Central Farm in Los Angeles, which pitted developers against urban gardeners (including actor, Daryl Hannah), and went on to be the subject of documentary, The Garden.

“The developer has to really get involved”, says Jon. Prima properties needed to form a relationship between the community, foster a gardening committee and remain involved with the project; otherwise, it wouldn’t work.

To that end, they remain participants in other West-End activities, such as Davie Days. According to Jon, the success of this collaboration “shows in the garden”.

Community Advocates

There are numerous community groups with an active interest in community gardens. Vancouver Public Space Network (VPSN) has a mandate “to preserve and celebrate public space as an essential part of a vibrant, inclusive city”.

It has been instrumental in setting up several community gardens including both the Seymour and Davie Village ones. Also, West End Residents’ Association (WERA) with Gordon House and the YMCA are proposing a new community garden on land governed by the Vancouver Park Board.

Volunteers

As any avid gardener knows, a garden is a perfect reflection of the gardener’s well being—weeds, wonders and all. The same is true of a community garden: it is an accurate reflection of the health of a community.

One Davie Village gardener, Bob Cassidy, has three plots, which keeps him buzzing around on a daily basis. “I’ve met people of all ages and from all walks of life”. He described the monthly work parties, which bring all the gardeners together and, of course, the curious who are drawn to this inviting urban oasis.

With the large homeless population in the downtown core, it is natural to assume that light fingers might prevail and tomatoes go missing. Jon takes theft by local hungry and homeless folks in stride, “if you want to have a tomato, grow ten”. Other gardeners are more vigilant about protecting their labours.

There’s also the confusion arising from the perimeter plots (plots next to the sidewalk), originally designed to be open to everybody to garden, but this arrangement caused friction between gardeners, so all plots are now assigned. Perimeter plots continue to supply food to the nearby Burrard Youth Shelter.

Health care documentation and training plan

Type: Planning documents
Objective: Show how training materials could be improved
Purpose: Convey need for a single-source solution
Audience: Health care decision-makers

CKD Patient Registration

With CKD Patient Registration (designed for clinical staff to enter important kidney care information into the clinical software system), the first challenge with training was economising the efforts taken to create and maintain the documentation. I advocate for a single-source solution that organises information into chunks for re-use. While the ultimate solution is to use a topic-based authoring tool such as Madcap Flare, something similar can be obtained using less feature-rich software.

With the samples below, I started with that big picture of single-sourcing and drilled down to a lesson organised into different clinical scenarios for transferring patients. Although the Adobe Captivate elearning isn’t available to share here, I’ve included similar material (KCC Patient Transfers) that, for the first time, links the software features to real-world clinical procedures.

Selected files:

Testimonial – Gloria Freeborn, Director of Strategic Organizational Development, BC Renal Agency

Jason is able to bridge the worlds of IT and healthcare, crafting messaging about clinical information systems that is clear and easy-to-understand for a range of care providers, from administrators to front-line staff. During his time with the BC Renal Agency, he developed a range of communication tools and streamlined workflow processes.

—Gloria Freeborn, Director of Strategic Organizational Development, BC Renal Agency

Grammar NAZIs! Meet your Nuremberg Trial

Or…When good grammar just isn’t good enough…

Vancouver’s suburban Lougheed Highway wends its way through Burnaby with predictable consistency. At each Skytrain station paralleling the route follows a rhythmic punctuation of corporate conformity — a London Drugs, a Starbucks, a Buy-Low Foods, a capping glass condo tower. Then repeat to the horizon line. Monotony enough to put envy into the heart of any Cold War-era urban planner. So much for Capitalist diversity.

How gratifying to know then that there are a few cells of non conformity hiding within the corporate state. Take for example, the copy editor. While much of the literate world has long since parsed out the difference between “its” and “it’s”, how refreshing to come upon a non-conformist writer who dares to shake up the rules of grammar a bit. Otherwise, explain these gems.

With its jazzy use of “it’s”, I find this subtitle scintillating. It jumps out like a tangy note of peppercorn in an otherwise grey merlot. “It’s top business sectors” or more accurately “It is top business sectors” connotes authority in a way the correct form just can’t.

Don’t be fooled — the clever writer of this next one knows how to get eyeballs on paper.

Amphibious

Compared with the worn-out tricks of social media gurus and their endless listicles (“OMG – The 7 Things you need to know about nose hairs that will completely change your life forever!”), I’ll choose the well-placed malapropism every time!

There are corporate disruptors; then there are the outright anarchists. The latter I believe to be behind this next masterpiece of subject/pronoun mixology.

Subject/verb agreement magnum opus

Subject/verb agreement magnum opus

Putting aside the grey imagery of office furniture representing not a company and most certainly not people, it would be so simple to just change “company” to “companies” and put an end to this vertiginous dance between the pronoun (“them”) and its potential suitors (the two nouns in the sentence). But isn’t “company” a “them”, which has people in them? Yeah I s’pose, but it’s a collective noun so it should be singular…but wait, it’s people we’re talking about…them is people. Inside people? You see. That’s why I prefer the roller coaster whiplash Magna Search Group unleashed to the pedantic approach favoured by textbooks. It’s far more exciting.

And can you imagine yourself a fly on a wall at the Marketing think tank when they came up with such a slogan? Okay start again, “Only a company is good, if they have people in them.” No, “Inside of a company, they is people, good ‘uns.”, No wait, I’ve got it. “Outside of a dog, a book is a man’s best friend. Inside of a dog it’s too dark to read”, um…

This next one is just pure anarchy and needs no further comment.

It's raining cats and dogs, with a chance of lizzards this evening...

It’s raining cats and dogs, with a chance of lizzards this evening…

Choosing a Style Guide

If you’re a writer, particular a writer where technical accuracy is important, you need a good set of standards as your reference point. Style guides establish standards and consistency and are especially useful to large organizations where many people are working together on the same project. Below is a sampling of several style guides; some are industry standards used by technical writers while others provide an insight into in-house standards used at differing organizations.

Download any you like:

  • The Chicago Manual of Style – A great resource for technical writers. There’s great information also on laying out documents according to their type.
  • Strunk & White – Elements of Style – This is still a standard even though some of the prescriptive directions seem quaint nowadays (literally).
  • Microsoft Manual of Style – Check how it describes Windows interface naming
  • Apple Style Guide (2009) – Check how it handles units of measure
  • BCIT Graphic Standards 2013 – Even images and graphics need a style guide. This graphics standard guide from BCIT is typical of this genre and of great use to anyone how wants to design a manual to represent BCIT. It includes exact descriptions of branding, logos, colours, type faces, and more.
  • WorkSafeBC Editorial Style Guide – This is a good example of a style guide used in-house by a large organization. Their treatment of how to handle jargon in writing is worth a read.
  • Vancouver Style Guide – This guide, from the University of Queensland (Australia), describes a citation standard known, apparently, by librarians as Vancouver style.
  • Canadian Press Style Guide An Overview – This excerpt from the CP style guide provides good information on how to handle (i.e., capitalize) formal titles.

Testimonial – Thu Huynh, Training Manager, Webtech Wireless

Jason introduced a new approach for doing our installation guides, many examples of which I continue to use in the way we do things today.

—Thu Huynh, Training Manager, Webtech Wireless

10 top stories – tooting my own horn

Award-Winning

Over the last five years, I’ve written so many stories, blogs, and articles that it’s easy to lose track of what they are and what made them work.

To come up with a short list, I’ve chosen ten top stories and assigned “award categories”:

Best headline – This concert review might have gone unnoticed had I not tied one of the pieces performed with issues critical to The Vancouver Observer’s news coverage. The result: Erato Music got much more attention from readers who might not otherwise have taken an interest in chamber music.

“Oilblood” re-imagines Harper with Baroque vengeance

Best use of images (supplied) – I worked with Bicycle Opera and their photographer to find really compelling photos to help tell this interesting and quirky story. In the end, I also pirated several photos from their Facebook page

Bicycle Opera wheels into rural Ontario

Best use of images (I took) – This was a really interesting article to write. It was part music story, research project, and travel story and perhaps owing to the fact that I was a participant to these workshops in California, my photography skills came through.

The Balkan Music and Dance Workshops: re-thinking dissonance

Best niche story – There’s no niche for this story really, because it’s so weird an quirky. Still, there’s a real person who made his own drum kit that could be transported by bicycle.

Musical instrument makers on bikes

Best interview –  Also, on the theme of musical instrument makers, this story describes in great detail two Vancouver-based musical instrument makers. I visited their workshops and photographed them at work.

Discovering Vancouver’s hidden music makers

Most detailed historical travel story – I like this story because it shows one of the most saturated travel destinations, Paris, from the perspective of a lone cyclist not afraid to go anywhere to dig up some good history.

Unforgettable bicycle trips around Paris: Notre Dame, Château de Vincennes, Arc de Triomphe

From my three-and-a-half years at Webtech Wireless, a few outstanding stories emerged:

Best corporate technology story –  I attended a trucking trade show in Orlando and attended a talk about data – yawn. But wait, then I wove it into a colourful story drawing a thread of continuing from Sumo wrestlers, Arkansas Governor Mike Huckabee, and Québec performance artist, Jean Francois–all who had something to say about perspective.

Drawing Intelligence from Data

Best corporate human story – I interviewed Webtech Wireless firmware engineer, Alireza Nematollahi, and wrote about his success as a national kayak champion and drew a connection to his testing work at Webtech. When I criticize formulaic blog writing, I see this as an example of what corporate blogs could be. 

Testing the Limits

Best corporate hay-making story – Here, I found a connection between the temperature monitors Webtech Wireless makes for food transportation and world hunger. The statistics for food wastage in transport are huge, so it wasn’t an unreasonable stretch–certainly one I was happy to make.

Cargo Temperature Monitoring Helps Reduce Hunger

Best corporate culture/technology tie-in story – I decided to write our weekly blog as a travel story and sing the praises of Ottawa’s winter celebrations (and its fabled Rideau Canal skating rink), while slipping in the expected corporate blog about how the City of Ottawa uses Webtech Wireless technology to ensures its roads are kept ice free.

Winter Fleets—Let’s Celebrate!