IT SOLUTIONS
Your full service technology partner! 
-Collapse +Expand
Tech Writer
Search Tech Writer Group:

Advanced
-Collapse +Expand Tech Writer Store
   ► KBRole-Based T...Technical Wr...   Print This     

Tech Writer KB: Technical Writing Topic

Topics

33 Articles Found in the Technical Writing Topic  (or one of the sub-topics in bold above)

  KB Article    

Mike Prestwood
1. "a lot" and "allot"

a lot, not alot
to a very great degree or extent

"John is a lot better programmer than Dave."
 

allot
to divide or distribute by share or portion

"I am going to allot you half the analysis."

Posted to KB Topic: Spelling Pitfalls
8 years ago

Tip
Nothing New Since Your Last Visit
5531
Hits

Technical Writing

Mike Prestwood
2. a versus an

a
not any particular or certain one; a certain; another; one;

"He is a Delphi programmer."
 

an
the form of "a" before an initial vowel

"He is an ObjectPAL programmer."

Posted to KB Topic: Grammar
8 years ago

Tip
Nothing New Since Your Last Visit
5696
Hits

Technical Writing

Mike Prestwood
3. ABC Amber HLP Converter

Converts HLP files to many formats including PDF, RTF, HTML, DOC, CHM, TXT, DBF, XML, CSV, XLS, MDB, MCW, etc.

Posted to KB Topic: MS Windows Help Files (.HLP)
9 years ago

Download
Nothing New Since Your Last Visit
6950
Hits

Technical Writing

Ramesh R
4. API documentation - documenting the program code

Overview and tips for documenting an Application Programming Interface (API).

9 years ago, and updated 8 years ago

KB Post
Nothing New Since Your Last Visit
5533
Hits

Technical Writing

Peter Gruenbaum
5. API Documentation Survey Results

In a perfect world, API documentation would contain clear, complete instructions on everything that developers need to know to use your platform. In reality, organizations have limited time and budget to create API documentation, and so organizations need to prioritize to create documentation that is most useful to the people who will use it.

SDK Bridge set out to find out what is most important to the people who use APIs by sending out a survey and asking them. We found, not surprisingly, that many thought that documentation could be better. When asked to rate quantitatively, people rated overviews, sample code, and API references the highest, followed closely by tutorials. When asked for open-ended comments, a large percentage mentioned working sample code as helpful, and an equally high percentage mentioned how important it is that documentation be complete and accurate. Two other important factors that were mentioned by several respondants are (1) it is very helpful to explain why you would use something in addition to how you use it and (2) completeness and accuracy are critical.

6 years ago, and updated 6 years ago

Article
Nothing New Since Your Last Visit
5474
Hits

Technical Writing

Ramesh R
6. Conceptual Thinking

Conceptual thinking deals with conceptualization theory and helps in assessing or dealing with complex situations. This is very important especially while working with user documentation projects or while performing writing of content.

5 years ago

Article
Nothing New Since Your Last Visit
1982
Hits

Technical Writing

Ramesh R
7. Critical Thinking in technical writing

Critical Thinking skills comes automatically as a writer becomes experienced over a period of time. Learning to write and transforming the ideas into writing help develop critical thinking aspects/skills. A clear set of phases/activities are inititated in the human brain as part of critical thinking. This article helps to understand the learning basics, learning process and the impact of writing that drives critical thinking skills. This is a good read for all our technical writing friends across the globe.

Posted to KB Topic: General, Getting Started, etc.
7 years ago

Article
Nothing New Since Your Last Visit
10504
Hits

Technical Writing

Peter Gruenbaum
8. Crowd-Sourcing API Documentation

Crowd-sourcing (that is, using Web-based technology to gather API documentation content from your users) has the potential to lower documentation costs and make your documentation more relevant. However, relying solely your developer community to provide documentation will result in uneven quality and coverage. I recommend a hybrid approach, where professional programmer/writers write parts of the documentation, as well as rewrite and polish content from the community. Several tools are available that enable communities to contribute documentation content. 

7 years ago
(1 Comments )

Article
Nothing New Since Your Last Visit
9793
Hits

Technical Writing

Ramesh R
9. Global Dashboard - Metrics for documentation processes This article presents an overview of the global dashboard and the related metrics for all regions, specifically for documentation teams. This helps the user to understand and gain more knowledge on the metrics, measures and quality standards used for content management, portal management, elearning systems teams.
Posted to KB Topic: General, Getting Started, etc.
9 years ago

Article
Nothing New Since Your Last Visit
9091
Hits

Technical Writing

Peter Gruenbaum
10. Guidelines for Good Sample Code

Sample code often provides the quickest, clearest way to learn how an SDK works. If you have software engineering experience, then you should already know many principles for writing good code. However, what you may not realize is that some of the good practices that you learned for writing good production code do not apply to writing good sample code. Some techniques, such as comments and clear variable names, apply to both production code and sample code. However, there are good reasons to use hard-coded values in sample code, which should be avoided in production code, and there are good reasons to avoid object-oriented designs when writing sample code.

8 years ago
(1 Comments , last by Anonymous )

Article
Nothing New Since Your Last Visit
15706
Hits

Technical Writing

Wes Peterson
11. Help and Manual: A great authoring tool http://www.ec-software.com/products_hm_overview.html
9 years ago, and updated 9 years ago

Link
Nothing New Since Your Last Visit
6112
Hits

Technical Writing

Wes Peterson
12. HelpScribble - an amazing tool http://www.helpscribble.com/
9 years ago, and updated 9 years ago

Link
Nothing New Since Your Last Visit
5975
Hits

Technical Writing

Mike Prestwood
13. Hung versus Hanged

Use "hung" for things and longer durations. Use "hanged" for people and shorter durations.

Examples:

"I hung a picture on the wall."

"He hung a deer on a tree for butchering."

"Felicia and Ashley hung out last night."

"Horse theives were hanged in the 19th century."

"The terrorist was hanged and his corpse was hung on the tree."

Posted to KB Topic: Grammar
8 years ago

Tip
Nothing New Since Your Last Visit
6030
Hits

Technical Writing

Julia Bertschinger
14. Its vs. it's

"It's" always means "it is."

"It's," unlike pretty much all other words with an apostrophe and an "s", does not ever indicate a possessive.

"Its" is the possessive, strangely enough.

"It's a good program.": The same as "It is a good program."

"It's features are impressive.": The same as "It is features are impressive," which is wrong.

"Its features are impressive.": Correct!

Posted to KB Topic: Grammar
8 years ago
(1 Comments , last by Himanshu.M )

Tip
Nothing New Since Your Last Visit
6191
Hits

Technical Writing

Ramesh R
15. Knowledge Management An overview of knowledge management in corporate companies with the basics providing information peratining to such knowledge management teams that lead to greater organizational growth and individuals growth also.
Posted to KB Topic: General, Getting Started, etc.
9 years ago
(2 Comments , last by Anonymous )

Article
Nothing New Since Your Last Visit
6716
Hits

Technical Writing

Ramesh R
16. Learning - by sharing information

The key aspects of learning evolve by sharing or exchanging information with your peers. For a technical writer, it is very much important to focus/target towards a technical topic. This article presents a short information about the key aspects of learning and the methods/techniques used to enable the learning curve.

Posted to KB Topic: General, Getting Started, etc.
8 years ago

Article
Nothing New Since Your Last Visit
5501
Hits

Technical Writing

Mike Prestwood
17. Lulu.com Self Publishing http://www.lulu.com/
Posted to KB Topic: Publishing
9 years ago

Link
Nothing New Since Your Last Visit
4440
Hits

Technical Writing

Mike Prestwood
18. Prestwood Online Style Guide Use up to four levels within articles (Heading 1..4). Within text, bold language elements and menu options. Use italics to bring attention to non-code things such as companies, important words, etc. Use bold+Italic for embedded topics and follow with a colon. Use the paragraph style for text and preformatted for code. Max width for images is 700 pixels.
Posted to KB Topic: Publishing
9 years ago, and updated 9 years ago

KB Post
Nothing New Since Your Last Visit
13101
Hits

Technical Writing

Ramesh R
19. Quick Tips: Writing a Marketing Plan

Marketing plan is the first prerequisite once the company decides with bringing the product to the market. It is important to analyze market conditions, growth aspects before starting to release any product. A marketing plan document is a good start and plays a very important role in understanding the market better. This plan discusses several different aspects of marketing strategy.

Posted to KB Topic: General, Getting Started, etc.
9 years ago, and updated 7 years ago

KB Post
Nothing New Since Your Last Visit
9937
Hits

Technical Writing

Mike Prestwood
20. Quit, Quiet, Quite
  • Quit: to stop, cease, or discontinue
  • Quiet: making no noise
  • Quite: completely, wholly, or entirely
Posted to KB Topic: Spelling Pitfalls
8 years ago

Tip
Nothing New Since Your Last Visit
8592
Hits

Technical Writing

lowster11
21. Rated by MSNBC.

Technical writing is an in-demand field and rated one of the top five high-paying, low stress jobs by MSNBC.

7 years ago
(2 Comments , last by Anonymous )

News
Nothing New Since Your Last Visit
5114
Hits

Technical Writing

Ramesh R
22. Social Media in Technical Communication http://www.tcworld.info/index.php?id=130
Posted to KB Topic: General, Getting Started, etc.
7 years ago

Link
Nothing New Since Your Last Visit
4804
Hits

Technical Writing

Peter Gruenbaum
23. Survey on SDK Documentation

A survey was sent to software developers and other software professionals to ask what was important in SDK documentation and where they would like to see improvement. The results indicated that the current state of typical SDK documentation is "Fair", which was the middle choice of five ("Excellent" to "Unusable"). The answers to multiple choice questions indicated that overviews, API references, sample code, and tutorials were all considered high importance, whereas blogs and forums were considered less important. When asked to write what they considered important, sample code was mentioned in 61% of the responses and overviews were mentioned in 30% of the responses. Also mentioned as important were help getting started, explanations of why something should be used, accuracy of information, and the ability to find information easily.

8 years ago

Article
Nothing New Since Your Last Visit
19151
Hits

Technical Writing

Julia Bertschinger
24. Teaching old thumbs new tricks - Tech Writing Blog

When I took a typing classs (not a keyboarding class, and yes, I know that dates me) I was taught that words had one space between them and sentences had two spaces in between them. Therefore, my thumbs, whose only job was to hit the space bar, learned that when a period was the last key typed, they had to hit the space bar twice instead of only once. They were good at this and were quite proud of their skill.

Now the rules have changed. The convention, especially for�material to be read on a screen, is that sentences have only one space between them. My thumbs have been rebelling. When I type, they want to put TWO spaces after a period. When I am typing something formal, in addition to checking my spelling and grammar, I also need to�check how many spaces are between each sentence.

Luckily, my thumbs are starting to adjust, and I am finding fewer and fewer double spaces between sentences. Thumbs can learn new tricks.

Posted to KB Topic: General, Getting Started, etc.
7 years ago

Blog
Nothing New Since Your Last Visit
5945
Hits

Technical Writing

Ramesh R
25. Technical Writing Domains

A large set of technical writing work have grown up and it has started spanning across several domains. Documentation is strictly a requirement by most of the companies when we look at information management techniques as a whole. Over a period of time, the documentation changes need to be tracked and verified including the release changes and changes in development/API. Technical writing is not just limited to software or hardware or products as such. It is existing across several domains. Let us try to understand the various domains in which technical writing offers it role.

8 years ago

Article
Nothing New Since Your Last Visit
6998
Hits

Technical Writing

Peter Gruenbaum
26. The Five Biggest API Documentation Mistakes and How to Avoid Them

Good API documentation can have a tremendous impact on whether a software platform is adopted. However, too often API documentation ends up being confusing and hard to follow, which results in developers choosing another way to accomplish their goals. This article describes five common mistakes that are made in creating API documentation and describes solutions to avoiding those mistakes. Following good API documentation practices can provide developers with the content that they need to be able to take full advantage of a software platform's capabilities. 

Posted to KB Topic: General, Getting Started, etc.
8 years ago, and updated 7 years ago
(9 Comments , last by peter2 )

Article
Nothing New Since Your Last Visit
15447
Hits

Technical Writing

Mike Prestwood
27. then versus than

then
adverb - at that time; adjective - being; noun - that time

"Create the database, then start the prototype."

than
in relation to; by comparison with

"Delphi 6 is a better product than Visual Basic 6."

Posted to KB Topic: Grammar
8 years ago

Tip
Nothing New Since Your Last Visit
5313
Hits

Technical Writing

Peter Gruenbaum
28. Using Real World Scenarios in Conceptual Documentation

Using real world scenarios when you write conceptual documentation for Software Development Kits (SDKs) is a way to give your readers ideas as to how the SDK can be used and to guide them as to what APIs are needed for commonly expected scenarios. This article guides you through how to gather information about scenarios, how to simplify them in order to make good examples, and how to lead developers through which APIs to use.

8 years ago

Article
Nothing New Since Your Last Visit
12574
Hits

Technical Writing

Peter Gruenbaum
29. Web API Documentation

The number of Web APIs is growing rapidly, especially with the increasing popularity of Software as a Service. Because Web APIs are still fairly new, the quality and format of their documentation varies a great deal. Good documentation is important for Web APIs because experimentation is more difficult than with local APIs. Because Web APIs are language-neutral, you may need to write sample code in a variety of different languages. Be sure to cover authentication, error handling, and HTTP information.

7 years ago, and updated 7 years ago
(3 Comments , last by Anonymous )

Article
Nothing New Since Your Last Visit
20664
Hits

Technical Writing

Ramesh R
30. What is technical writing? About technical writing and the knowledge domain.
Posted to KB Topic: General, Getting Started, etc.
9 years ago, and updated 9 years ago
(2 Comments , last by Wes )

KB Post
Nothing New Since Your Last Visit
7131
Hits

Technical Writing

Mike Prestwood
31. who versus whom "him" is for "whom" and "he" is for "who" Who is coding that requirement? (He is coding it.) To whom do we ask about this requirement? (We ask him.)
Posted to KB Topic: Grammar
9 years ago, and updated 9 years ago
(1 Comments , last by Wes )

Tip
Nothing New Since Your Last Visit
7079
Hits

Technical Writing

Wes Peterson
32. Wink Software -- Author Animated Tutorials As developers, we can often help our clients (or our marketing efforts) by creating "screen cast" demos or tutorials. Here is a great tool for doing that - and it's free.
10 years ago, and updated 9 years ago

Download
Nothing New Since Your Last Visit
7655
Hits

Technical Writing

Ramesh R
33. Writing as a process Writing applies to any sort of information. However, writing in general is a generic process that involves many components. Writing itself is a big process that includes many things within itself. It is not easy to write and convey information to end user. Writing require experience, grammar skills, domain knowledge, process knowledge, etc. By this, we would be able to understand the importance of writing.
Posted to KB Topic: General, Getting Started, etc.
9 years ago

KB Post
Nothing New Since Your Last Visit
7848
Hits

Technical Writing

Icon Legend:
Since your last logged visit:
- New to you or updated since your last visit (sign in now to activate).
- NOT new to you since your last visit (sign in now to activate).

New Technical Writing Knowledge Base Post...

Share your knowledge with the WORLD! In addition to adding comments to existing posts, you can post knowledge you've acquired. We welcome full articles (intro with screen shots), general posts (shorter), and tidbits (tips, FAQs, definitions, etc.).

Post New...

Tidbit Post: Short Flashcard FAQ Definition Quick Tip Code Snippet
Longer Post: Full Article General Post File Link Error News
Other: Blog Topic
Or, if YOU have a question...
  Technical Writing Message Board
-
   Contact Us!
 
Have a question? Need our services? Contact us now.
--Mike Prestwood

Call: 916-726-5675

email: info@prestwood.com


Go ahead!   Use Us! Call: 916-726-5675 


©1995-2017 Prestwood IT Solutions.   [Security & Privacy]