Twitter / MYOBapi: Early morning whiteboard thinking ...
twitter.com
on 04/04/2013
Excerpt: When you tweet with a location, Twitter stores that location. You can switch location on/off before each Tweet and always have the option to delete your location history. Learn more
Not on Twitter?... read the full post.
Tags: API-Evangelist, API-Stack, Documentation, How-To, Learning, OAuth
Discover Better API Documentation at the First Write the Docs Conference
blog.programmableweb.com
on 03/29/2013
Excerpt: In Abraham Lincoln’s famous A House Divided speech, he detailed the importance of planning: “If we could first know where we are, and whither we are tending, we could better judge what to do, and how to do it. ” The same need holds true in the API world. Thus, technical writers and documentarians will embark on a two journey in hopes to refine the technical documentation and writing process at Write the Docs (April 8-9). Those who interact with APIs on a consistent basis understand the importance of well designed, clean documentation. Many argue that API documentation trumps any feature, SDK, or ease of use as the single most important piece of an API.... read the full post.
Tags: API-Evangelist, API-Stack, Documentation
EasyPost | Docs - cURL
www.geteasypost.com
on 03/26/2013
Excerpt: Below is a quick overview of the EasyPost API using cURL for the examples. If anything is unclear or not working as intended please let us know. Addresses
For valid addresses the return value is just address. Note that some data can be missing and still result in a valid address. For instance, if you forget to include the state we will try to fill this in for you and add this data to the returned JSON. Input
curl https://www. geteasypost.... read the full post.
Tags: API-Evangelist, API-Stack, Building Blocks, Documentation
Tools to generate beautiful API documentation
www.mattsilverman.com
on 02/16/2013
Excerpt: As demand for our Nutritionix API is starting to grow rapidly, we have been working on finding an API documentation engine to meet our needs for the long-term. I was not able to find any comprehensive list of existing API documentation solutions, so I am compiling what I have found so far. Please leave feedback on your own experience in the comments. We are still exploring each solution, but I will update this post as we learn more about each option. Swagger - A specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services. [Demo] Note: We already use 3Scale. net for our API management solution, and they have an ActiveDocs feature based on Swagger.... read the full post.
Tags: API-Evangelist, API-Stack, Documentation, Interactive Documentation
Preview the Spring ’13 Developer Docs
blogs.developerforce.com
on 12/21/2012
Excerpt: Stay tuned for more announcements, and don’t forget to register for the Spring ’13 Release Developer Preview webinar on January 30, 2013 to get an overview of the key features you shouldn’t miss. tagged API, application development, documentation, preview, release, Spring '13Bookmark the permalink. Trackbacks are closed, but you can post a comment.... read the full post.
Tags: API-Evangelist, CRM, Documentation, sales, SalesForce
Opening Up the Embedly Docs
blog.embed.ly
on 07/11/2012
Excerpt: Last month we announced our newly revamped documentation, with full-text search in the sidebar and thousands of tweaks. Today we're putting the docs in your hands. Linus Torvalds famously said that "Given enough eyeballs, all bugs are shallow. " That's just as true for documentation as it is for code. That's why we've made the raw reStructuredText markup behind our docs publicly available at https://github. com/embedly/embedly-docs/. Want write a new tutorial? Got a library we should be featuring? Found a mistake? Just fork the repo and send us a pull request. Once we accept it, it'll go up on https://embed. ly/docs/ within minutes.... read the full post.
Tags: Building Blocks, Documentation, Embed, Embedly, Social Media, Story
New and Updated Developer Documentation for Summer ’12
blogs.developerforce.com
on 06/05/2012
Excerpt: For your reading pleasure, we’ve updated the developer documentation on developer. salesforce. com and database. com. It reflects the new Summer ’12 Salesforce release (API version 25. 0). In addition, there are some new docs you might want to check out. The Open CTI Developer’s Guide is now available. This guide describes how to use Open CTI to build computer-telephony integration systems that integrate with Salesforce. Customizing Case Feed with Visualforce is now available. This guide describes how to customize Case Feed with Visualforce components. The REST Metadata API Developer Guide is now available. This guide describes the Metadata REST API, a RESTful API for retrieving and deploying setup information in your organization.... read the full post.
Tags: CRM, Documentation, SalesForce
David Linsin - Developers and Documentation
dlinsin.github.com
on 05/27/2012
Excerpt: The relationship between developers and documentation can be described like the bond between cats and dogs. They are on totally different levels of the food chain, so sometimes the relationship works out, but most of the time it doesn’t. If the cat and dog get along well you’ll have a happy home, but if they don’t you’ll live in a state of toleration - nothing more and nothing less. It is said that the best way of forming a healthy bond between a cat and a dog is to bring them up together. They’ll get to know each other from the beginning and learn to respect each other. I think that works well for the relationship of developers and documentation as well. When talking about documentation it’s important to differentiate.... read the full post.
Tags: APIs, Documentation
Interactive Documentation « The Scripted Company Blog
blog.scripted.com
on 05/10/2012
Excerpt: Your new-fangled, mobile-first social network will never get any traction if its UI is sloppy. Pinterest, Instagram and Airbnb have taught us that design is paramount to adoption. But APIs with awful documentation are a dime a dozen. An API’s documentation is its human interface, so why make it look like it was written for robots? Why can’t API documentation eat its own dogfood? The Scripted API Documentation is built on the Scripted API. It is dynamic and interactive. You can use it to build queries and test them without ever writing a line of code. If you are particularly masochistic, you could even use the API Docs instead of our user interface and walk away with 90% of the site’s functionality.... read the full post.
Tags: APIs, Documentation
Excerpt: In Abraham Lincoln’s famous A House Divided speech, he detailed the importance of planning: “If we could first know where we are, and whither we are tending, we could better judge what to do, and how to do it. ” The same need holds true in the API world. Thus, technical writers and documentarians will embark on a two journey in hopes to refine the technical documentation and writing process at Write the Docs (April 8-9). Those who interact with APIs on a consistent basis understand the importance of well designed, clean documentation. Many argue that API documentation trumps any feature, SDK, or ease of use as the single most important piece of an API.... read the full post.
Tags: API-Evangelist, API-Stack, Documentation
EasyPost | Docs - cURL
www.geteasypost.com
on 03/26/2013
Excerpt: Below is a quick overview of the EasyPost API using cURL for the examples. If anything is unclear or not working as intended please let us know. Addresses
For valid addresses the return value is just address. Note that some data can be missing and still result in a valid address. For instance, if you forget to include the state we will try to fill this in for you and add this data to the returned JSON. Input
curl https://www. geteasypost.... read the full post.
Tags: API-Evangelist, API-Stack, Building Blocks, Documentation
Tools to generate beautiful API documentation
www.mattsilverman.com
on 02/16/2013
Excerpt: As demand for our Nutritionix API is starting to grow rapidly, we have been working on finding an API documentation engine to meet our needs for the long-term. I was not able to find any comprehensive list of existing API documentation solutions, so I am compiling what I have found so far. Please leave feedback on your own experience in the comments. We are still exploring each solution, but I will update this post as we learn more about each option. Swagger - A specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services. [Demo] Note: We already use 3Scale. net for our API management solution, and they have an ActiveDocs feature based on Swagger.... read the full post.
Tags: API-Evangelist, API-Stack, Documentation, Interactive Documentation
Preview the Spring ’13 Developer Docs
blogs.developerforce.com
on 12/21/2012
Excerpt: Stay tuned for more announcements, and don’t forget to register for the Spring ’13 Release Developer Preview webinar on January 30, 2013 to get an overview of the key features you shouldn’t miss. tagged API, application development, documentation, preview, release, Spring '13Bookmark the permalink. Trackbacks are closed, but you can post a comment.... read the full post.
Tags: API-Evangelist, CRM, Documentation, sales, SalesForce
Opening Up the Embedly Docs
blog.embed.ly
on 07/11/2012
Excerpt: Last month we announced our newly revamped documentation, with full-text search in the sidebar and thousands of tweaks. Today we're putting the docs in your hands. Linus Torvalds famously said that "Given enough eyeballs, all bugs are shallow. " That's just as true for documentation as it is for code. That's why we've made the raw reStructuredText markup behind our docs publicly available at https://github. com/embedly/embedly-docs/. Want write a new tutorial? Got a library we should be featuring? Found a mistake? Just fork the repo and send us a pull request. Once we accept it, it'll go up on https://embed. ly/docs/ within minutes.... read the full post.
Tags: Building Blocks, Documentation, Embed, Embedly, Social Media, Story
New and Updated Developer Documentation for Summer ’12
blogs.developerforce.com
on 06/05/2012
Excerpt: For your reading pleasure, we’ve updated the developer documentation on developer. salesforce. com and database. com. It reflects the new Summer ’12 Salesforce release (API version 25. 0). In addition, there are some new docs you might want to check out. The Open CTI Developer’s Guide is now available. This guide describes how to use Open CTI to build computer-telephony integration systems that integrate with Salesforce. Customizing Case Feed with Visualforce is now available. This guide describes how to customize Case Feed with Visualforce components. The REST Metadata API Developer Guide is now available. This guide describes the Metadata REST API, a RESTful API for retrieving and deploying setup information in your organization.... read the full post.
Tags: CRM, Documentation, SalesForce
David Linsin - Developers and Documentation
dlinsin.github.com
on 05/27/2012
Excerpt: The relationship between developers and documentation can be described like the bond between cats and dogs. They are on totally different levels of the food chain, so sometimes the relationship works out, but most of the time it doesn’t. If the cat and dog get along well you’ll have a happy home, but if they don’t you’ll live in a state of toleration - nothing more and nothing less. It is said that the best way of forming a healthy bond between a cat and a dog is to bring them up together. They’ll get to know each other from the beginning and learn to respect each other. I think that works well for the relationship of developers and documentation as well. When talking about documentation it’s important to differentiate.... read the full post.
Tags: APIs, Documentation
Interactive Documentation « The Scripted Company Blog
blog.scripted.com
on 05/10/2012
Excerpt: Your new-fangled, mobile-first social network will never get any traction if its UI is sloppy. Pinterest, Instagram and Airbnb have taught us that design is paramount to adoption. But APIs with awful documentation are a dime a dozen. An API’s documentation is its human interface, so why make it look like it was written for robots? Why can’t API documentation eat its own dogfood? The Scripted API Documentation is built on the Scripted API. It is dynamic and interactive. You can use it to build queries and test them without ever writing a line of code. If you are particularly masochistic, you could even use the API Docs instead of our user interface and walk away with 90% of the site’s functionality.... read the full post.
Tags: APIs, Documentation
Excerpt: As demand for our Nutritionix API is starting to grow rapidly, we have been working on finding an API documentation engine to meet our needs for the long-term. I was not able to find any comprehensive list of existing API documentation solutions, so I am compiling what I have found so far. Please leave feedback on your own experience in the comments. We are still exploring each solution, but I will update this post as we learn more about each option. Swagger - A specification and complete framework implementation for describing, producing, consuming, and visualizing RESTful web services. [Demo] Note: We already use 3Scale. net for our API management solution, and they have an ActiveDocs feature based on Swagger.... read the full post.
Tags: API-Evangelist, API-Stack, Documentation, Interactive Documentation
Preview the Spring ’13 Developer Docs
blogs.developerforce.com
on 12/21/2012
Excerpt: Stay tuned for more announcements, and don’t forget to register for the Spring ’13 Release Developer Preview webinar on January 30, 2013 to get an overview of the key features you shouldn’t miss. tagged API, application development, documentation, preview, release, Spring '13Bookmark the permalink. Trackbacks are closed, but you can post a comment.... read the full post.
Tags: API-Evangelist, CRM, Documentation, sales, SalesForce
Opening Up the Embedly Docs
blog.embed.ly
on 07/11/2012
Excerpt: Last month we announced our newly revamped documentation, with full-text search in the sidebar and thousands of tweaks. Today we're putting the docs in your hands. Linus Torvalds famously said that "Given enough eyeballs, all bugs are shallow. " That's just as true for documentation as it is for code. That's why we've made the raw reStructuredText markup behind our docs publicly available at https://github. com/embedly/embedly-docs/. Want write a new tutorial? Got a library we should be featuring? Found a mistake? Just fork the repo and send us a pull request. Once we accept it, it'll go up on https://embed. ly/docs/ within minutes.... read the full post.
Tags: Building Blocks, Documentation, Embed, Embedly, Social Media, Story
New and Updated Developer Documentation for Summer ’12
blogs.developerforce.com
on 06/05/2012
Excerpt: For your reading pleasure, we’ve updated the developer documentation on developer. salesforce. com and database. com. It reflects the new Summer ’12 Salesforce release (API version 25. 0). In addition, there are some new docs you might want to check out. The Open CTI Developer’s Guide is now available. This guide describes how to use Open CTI to build computer-telephony integration systems that integrate with Salesforce. Customizing Case Feed with Visualforce is now available. This guide describes how to customize Case Feed with Visualforce components. The REST Metadata API Developer Guide is now available. This guide describes the Metadata REST API, a RESTful API for retrieving and deploying setup information in your organization.... read the full post.
Tags: CRM, Documentation, SalesForce
David Linsin - Developers and Documentation
dlinsin.github.com
on 05/27/2012
Excerpt: The relationship between developers and documentation can be described like the bond between cats and dogs. They are on totally different levels of the food chain, so sometimes the relationship works out, but most of the time it doesn’t. If the cat and dog get along well you’ll have a happy home, but if they don’t you’ll live in a state of toleration - nothing more and nothing less. It is said that the best way of forming a healthy bond between a cat and a dog is to bring them up together. They’ll get to know each other from the beginning and learn to respect each other. I think that works well for the relationship of developers and documentation as well. When talking about documentation it’s important to differentiate.... read the full post.
Tags: APIs, Documentation
Interactive Documentation « The Scripted Company Blog
blog.scripted.com
on 05/10/2012
Excerpt: Your new-fangled, mobile-first social network will never get any traction if its UI is sloppy. Pinterest, Instagram and Airbnb have taught us that design is paramount to adoption. But APIs with awful documentation are a dime a dozen. An API’s documentation is its human interface, so why make it look like it was written for robots? Why can’t API documentation eat its own dogfood? The Scripted API Documentation is built on the Scripted API. It is dynamic and interactive. You can use it to build queries and test them without ever writing a line of code. If you are particularly masochistic, you could even use the API Docs instead of our user interface and walk away with 90% of the site’s functionality.... read the full post.
Tags: APIs, Documentation
Excerpt: Last month we announced our newly revamped documentation, with full-text search in the sidebar and thousands of tweaks. Today we're putting the docs in your hands. Linus Torvalds famously said that "Given enough eyeballs, all bugs are shallow. " That's just as true for documentation as it is for code. That's why we've made the raw reStructuredText markup behind our docs publicly available at https://github. com/embedly/embedly-docs/. Want write a new tutorial? Got a library we should be featuring? Found a mistake? Just fork the repo and send us a pull request. Once we accept it, it'll go up on https://embed. ly/docs/ within minutes.... read the full post.
Tags: Building Blocks, Documentation, Embed, Embedly, Social Media, Story
New and Updated Developer Documentation for Summer ’12
blogs.developerforce.com
on 06/05/2012
Excerpt: For your reading pleasure, we’ve updated the developer documentation on developer. salesforce. com and database. com. It reflects the new Summer ’12 Salesforce release (API version 25. 0). In addition, there are some new docs you might want to check out. The Open CTI Developer’s Guide is now available. This guide describes how to use Open CTI to build computer-telephony integration systems that integrate with Salesforce. Customizing Case Feed with Visualforce is now available. This guide describes how to customize Case Feed with Visualforce components. The REST Metadata API Developer Guide is now available. This guide describes the Metadata REST API, a RESTful API for retrieving and deploying setup information in your organization.... read the full post.
Tags: CRM, Documentation, SalesForce
David Linsin - Developers and Documentation
dlinsin.github.com
on 05/27/2012
Excerpt: The relationship between developers and documentation can be described like the bond between cats and dogs. They are on totally different levels of the food chain, so sometimes the relationship works out, but most of the time it doesn’t. If the cat and dog get along well you’ll have a happy home, but if they don’t you’ll live in a state of toleration - nothing more and nothing less. It is said that the best way of forming a healthy bond between a cat and a dog is to bring them up together. They’ll get to know each other from the beginning and learn to respect each other. I think that works well for the relationship of developers and documentation as well. When talking about documentation it’s important to differentiate.... read the full post.
Tags: APIs, Documentation
Interactive Documentation « The Scripted Company Blog
blog.scripted.com
on 05/10/2012
Excerpt: Your new-fangled, mobile-first social network will never get any traction if its UI is sloppy. Pinterest, Instagram and Airbnb have taught us that design is paramount to adoption. But APIs with awful documentation are a dime a dozen. An API’s documentation is its human interface, so why make it look like it was written for robots? Why can’t API documentation eat its own dogfood? The Scripted API Documentation is built on the Scripted API. It is dynamic and interactive. You can use it to build queries and test them without ever writing a line of code. If you are particularly masochistic, you could even use the API Docs instead of our user interface and walk away with 90% of the site’s functionality.... read the full post.
Tags: APIs, Documentation
Excerpt: The relationship between developers and documentation can be described like the bond between cats and dogs. They are on totally different levels of the food chain, so sometimes the relationship works out, but most of the time it doesn’t. If the cat and dog get along well you’ll have a happy home, but if they don’t you’ll live in a state of toleration - nothing more and nothing less. It is said that the best way of forming a healthy bond between a cat and a dog is to bring them up together. They’ll get to know each other from the beginning and learn to respect each other. I think that works well for the relationship of developers and documentation as well. When talking about documentation it’s important to differentiate.... read the full post.
Tags: APIs, Documentation
