A directory of resources inthe field of technical communication.


5 found.

About this Site | Advanced Search | Localization | Site Maps

A software development kit (SDK) is typically a set of development tools that allows higher-end users (often software engineers) to create applications that take advantage of a certain software package, software framework, or similar platform. They are often a combination of technical writing, documentation, and sample code.



Eleven Syntax Highlighters To Beautify Code Presentation

When sharing codes on a website, even they are wrapped with CODE tags or styled differently, it is always a challenge to read them without syntax highlighting. There are various syntax highlighters which can format the codes & color them appropriately according to the languages used. Whether it is a HTML page or runs on PHP, Ruby, Python, ASP, there is a suitable syntax highlighter. Here is a collection of 11 Syntax Highlighters To Beautify Code Presentation.

Web Resources Depot (2009). Articles>Web Design>SDK>CSS


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.

Gruenbaum, Peter. Prestwood (2009). Articles>Software>SDK>Documentation


How to Create a Help API

In this post, I want to explore Help APIs, which is actually something in part enabled by static site generators. To put things in context, the web is sort of a giant API. Each browser functions as a client that accesses various resources from servers.

Johnson, Tom H. I'd Rather Be Writing (2015). Articles>Documentation>SDK>Technical Writing


Software Development Kit (SDK) Documents in 10 Simple Steps

Here are the ten simple steps to successful software development kit (SDK) documentation.

Buck, Catherine. KeyContent.org (2004). Articles>Documentation>SDK>Technical Writing


What Does Effective API Documentation Look Like?

Where the trend in tech writing is to NOT document everything, it appears that developers using API documentation want a lot more than the tech writers give them. That’s not to say that a tech writer (or even a team) should try to provide 156,000 code snippets, but clearly, in this particular case, Google is leaving their customers to fill a huge hole in their documentation that needs filling. Judging by the comments after the article, it’s not just Google that’s leaving developers in the lurch.

Minson, Ben. Beyond Help (2013). Articles>Documentation>SDK>Apple Keynote

Follow us on: TwitterFacebookRSSPost about us on: TwitterFacebookDeliciousRSSStumbleUpon