First off, I'd like to introduce myself.  I'm Kirsten Jones, the newest Developer Advocate here at LinkedIn.  The Developer Relations team is working hard to help you, our developers, achieve success using the LinkedIn API, including writing and organizing our documentation to make it easy to find what you need. To accomplish this, I'm going to add more examples and tutorials to the documentation and work to make the information clearer and more accessible.

That having been said, the first thing I tried to do when I got here was get OAuth working so I could start playing with the API.  And the first thing I thought was "Man, this documentation is kind of hard to follow."  Since I was already familiar with OAuth, it seemed to me it shouldn't have been that hard, even if OAuth isn't always a piece of cake to use. Since many developers don't already have OAuth experience, I decided to start by updating that documentation, because if you can't get starting using the LinkedIn APIs, you'll never get to build any cool applications using them.

To make the OAuth documentation more accessible, I split it into several pieces, so that you only need to look at the ones that are meaningful to you.

At the top level, Using OAuth with the LinkedIn APIs gets you started with an overview of what OAuth is and why we use it.  If you're not already familiar with OAuth, the OAuth Overview will help you understand how it works.

If you're already familiar with OAuth, you can skip directly to LinkedIn's OAuth Details. This page also documents how fields in your Application Details affect the OAuth flow, such as how to set a custom image for your application in the authorization window.

Last, I wrote a walkthrough and sample code for Getting an OAuth Token and Making an API Call with an OAuth Token.  The examples given are in python, but we're gathering together examples in other languages - and in fact would love any example code that our developers want to share. The more examples we can provide, the merrier - after all, as Adam has said before, we love all languages here!

I'll see you all on the forums, and let you know as we make more progress on our documentation.  I'm looking forward to working with all of you and seeing what amazing things you build!