Technical Writing and Writing for the Web

The following are the workshop notes for a presentation I gave recently to Portland Community College’s Technical Writing class. The topic was on web writing and writing for the web.

The main topics I covered in the workshop included:

  • Web platforms
    • Web publishing
    • Online personas
  • Writing for the Web
    • Web writing structure and format
    • Myths and Facts
  • Search Engine Optimization (SEO)
    • Demographics
    • Writing for your audience

Terminology

The following are terms and jargon used in blogging and social media.

  • Blogging: Publishing on the web through websites (blogs) and social media. Facebooking and Twitter are blogging, specifically microblogging.
  • Photoblogging: Publishing photography and words on the web through websites and social media.
  • Vlogging: Publishing video on the web.
  • Podcasting: Publishing scheduled and syndicated multimedia content on the web.
  • Social Media: Online marketing and community building.
  • SEO: (Search Engine Optimization) The process of making a site search engine friendly through code and content. Modern term for developing a site for search engine attention and distribution, aka marketing.
  • Web Publishing: Publishing on the web, sharing multimedia content in the virtual community.
  • Syndication: The distribution of content on the web through feeds.
  • Blog: A blog is a website with content displayed in reverse chronological order.

Continue reading

WordPress Site Structure and Organization

This article supports my recent presentation at PDX WordPress Meetup titled “Organizing Your WordPress Site.”

Please note that I’ve included articles from ClarkWP Magazine, the student run and managed site for my Clark College WordPress classes, as reference material throughout this article.

Before beginning to structure and organize, or reorganize, your WordPress site, there are some WordPress terms you need to know.

Whiteboard with site structure.

Continue reading

Web Writing: The Editorial Article

Editorial writing consists of writing and publishing an article that takes a stance on a topic. The position must be supported with documentation, reference material, and quotes.

Editorial writing for the web is based upon the fundamentals of traditional editorial writing, similar to op-eds but slightly different, modified by the needs of the web reading audience.

An op-ed piece is an opinion. It is distinguished from other articles in a magazine and newspaper as they may be well written but they do not represent the rules and guidelines required by journalists and reporters. The writers are typically not reports, nor educated in journalism.

An editorial article may be an opinion piece, but it is one that argues a specific point or perspective. On the web, an editorial article may be written by a reporter, journalist, professional writer, or anyone with a defensible opinion.

This article explores the specifics of editorial articles written and published on the web, specifically on blogs. It covers the basics of a web-based editorial article with tips, techniques, guidelines, and references. It is used by the students at Clark College in the web publishing courses taught by Lorelle VanFossen, and may be used by other educators. Continue reading

Stats: The Analytics of Reading to the Bottom of the Page

Featured

In “How people read online: Why you won’t finish this article” on Slate Magazine, author Farhad Manjoo explores the statistics on whether or not you will read to the bottom of his article.

I’m going to keep this brief, because you’re not going to stick around for long. I’ve already lost a bunch of you. For every 161 people who landed on this page, about 61 of you—38 percent—are already gone. You “bounced” in Web traffic jargon, meaning you spent no time “engaging” with this page at all.

So now there are 100 of you left. Nice round number. But not for long! We’re at the point in the page where you have to scroll to see more. Of the 100 of you who didn’t bounce, five are never going to scroll. Bye!

OK, fine, good riddance. So we’re 95 now. A friendly, intimate crowd, just the people who want to be here. Thanks for reading, folks! I was beginning to worry about your attention span, even your intellig … wait a second, where are you guys going? You’re tweeting a link to this article already? You haven’t even read it yet!

He talked to many expert web analytics researchers and analysts about the statistics associated with reading an article on the web. The numbers are fascinating, and may change how you write your next post.
Continue reading

Tutorial on Creating Footnotes in WordPress

Featured

Footnotes are often requested in my workshops and classes. I’ve published “Creating Footnotes in WordPress” explaining how to do this in WordPress on .

Footnotes have been replaced by links, but there may be times when you wish to link to a footnote in a blog post.

Here is a list of the pros and cons of using footnotes from the article.

Links cover one or more words thus are easier to see and easier to click over a larger area. Footnote links are tiny, hard to see, and hard to click, especially if you have mobility issues.

Footnotes are familiar to academics, scientists, and researchers. If you are publishing such papers or writing for that audience, it would be natural to include traditional footnotes.

There are also times when you may need to cite a source that isn’t online. How would you site a paper or reference that is not online? A footnote serves to cite the source while not interrupting the natural flow of the content with explanations in parentheses.

Three techniques are described in the article.

You may use WordPress Plugins that make adding footnotes to posts easier, or you can create them manually.

The process of adding footnotes manually to WordPress involves using jump or page links with the footnote numbers within the content to “jump” down to the footnote list at the bottom of the post.

I’ve included an example of how to create footnote jump links to take the reader to the footnote list and not a specific item in the list, and how to create a footnote jump link to a specific footnote in the list if there are many footnotes in the article.

How to Add Images in Your Post Content

Round beach rocks in shade - photography by Brent VanFossen.Images, graphics, photographs, drawings, cartoons, badges…our websites are filled with imagery.

This article addresses the techniques used by WordPress for aligning images and image sizing and links in published content. Check your publishing platform for their methods.

Image Terminology in WordPress

There are several terms we need to develop to help you understand how images are used in WordPress. The most important terms describe the images within WordPress based upon how they are used and generated: original image, published image, media file, and attachment image.

The image uploaded to your site is called the original image or image file. When uploaded to WordPress, a minimum of three sizes are automatically created and stored in the wp-content/uploads/ directory on the server. The images are grouped by year then month by default.

The image sizes available for displaying in your content are thumbnail, medium, and full-size. Depending upon the image’s original size, large and x-large may be available. Full-size is the original uploaded image size.

When an image is used on a web page in WordPress, it is typically viewed within the content area of a post or Page. For the sake of this tutorial, we will called this the published image. WordPress makes available the three size options by default.

Image Sizes and Links

WordPress Media Uploader featuring multiple images - screencap by Lorelle VanFossen.

The WordPress Media Uploader redesigned in 2012 now features Attachment Display Settings options. They include setting the alignment of the image, the size of the published image, and the Link To feature. Continue reading

What is a Properly Formed Link?

I talk about properly formed links or proper HTML anchor tags in all of my articles, workshops, and classes. This article serves as a tutorial and reference guide on the proper formation of HTML links.

Links tie the web together, linking one site to another, one web page to another. They are critical to helping us find information and understand what is being written.

In “What You Must Know About Writing on the Web,” I describe a link dump:

Ugly is as ugly does. Don’t clutter up your site with ugly link dumps.

A link dump is when the blogger is lazy and just pastes the link into their post such as https://lorelleteaches.com/2012/10/14/what-you-must-know-about-writing-on-the-web/ instead of the properly formed What You Must Know About Writing on the Web.

Which is easier to read?

A properly formed link makes it not just easier to read the post, it is clean and presents professional looking content. It invites the reader to click.

How to Create a Properly Formed HTML Link

To create a properly formed link, you may use the Visual Editor toolbar button called link or Hypertext Link.
Continue reading

This is an Example of a Blockquote

According to Lorelle:

We are all born with two ends. One is used for sitting. The other is not. Success in life depends upon which one you use the most. Heads you win. Tails you lose.

This is great wisdom of the ages, applicable to everyone, especially students.

I’m reminded of the old Hillbillies television show. There was an episode with the son, Jethro, where he decided, after jumping into the cement pond and bashing his head on the bottom, that he had a light bulb idea. He wanted to go to a fancy universiteee and become a world-famous neurosurgeon. His dad took one look at his son, trying to find a reason to feel pride and stay politically correct, and said, “Ain’t hope wonderful.”

Don’t be a Jethro.