This forum is a discussion about improving the "Open Search" article. If you'd like to participate, please register.

If you need help with Firefox, please ask a question.

Improve readability of article

  • 0 Replies
  • Last reply by Chris Ilias
  1. Chris Ilias 1972 posts
    Report Abuse

    Reviewing the recent edits to this article, this is the first time I’ve seen this article and really analyzed it. Rather than edit the article, I want to discuss my proposed changes first.

    The search summary "This article explains how to use Open Search to search various websites for words or phrases contained in email messages."

    • This article explains” can be removed, because it’s not needed.
    • "use Open Search to search various websites for words or phrases contained in email messages” makes a simple feature seem very technical. How about “Instantly take part of a message and search for it in Bing, Yahoo, Twitter or other websites."

    The article:

    • "Search search provider for “text”” is another example of being too technical. It’s confusing to read, and not what the user sees. You don’t have to say “search provider”. If the user knew how to change the search engine, they wouldn’t be looking up how to perform a search. We should try to use the words the user sees, so they know they are following instructions correctly. That means we can say Bing instead of “search provider”. The “text” part is more difficult. In that case, we can set up an example. Like this: “Let’s say you see the phrase “willing to make Hackasaurus” and want to search the web for Hackasaurus. Just highlight the word “Hackasaurus” then right-click and select “Search Bing for “Hackasurus"
    • The example should also be updated, because the screenshot doesn’t match the wording.
    • The subsequent sections both start with “By default”. I think both instances can be removed.
    Reviewing the recent edits to this article, this is the first time I’ve seen this article and really analyzed it. Rather than edit the article, I want to discuss my proposed changes first. The search summary "''This article explains how to use Open Search to search various websites for words or phrases contained in email messages.''" * “''This article explains''” can be removed, because it’s not needed. * "''use Open Search to search various websites for words or phrases contained in email messages''” makes a simple feature seem very technical. How about “''Instantly take part of a message and search for it in Bing, Yahoo, Twitter or other websites''." The article: * "''Search search provider for “text”''” is another example of being too technical. It’s confusing to read, and not what the user sees. You don’t have to say “search provider”. If the user knew how to change the search engine, they wouldn’t be looking up how to perform a search. We should try to use the words the user sees, so they know they are following instructions correctly. That means we can say Bing instead of “search provider”. The “text” part is more difficult. In that case, we can set up an example. Like this: “''Let’s say you see the phrase “willing to make Hackasaurus” and want to search the web for Hackasaurus. Just highlight the word “Hackasaurus” then right-click and select “Search Bing for “Hackasurus''" * The example should also be updated, because the screenshot doesn’t match the wording. * The subsequent sections both start with “''By default''”. I think both instances can be removed.