Documentation 2.0: DIY Content Delivery and Feedback in Real-time by Michael Lykhinin. Presentation at 2011 STC International Summit in Sacramento, CA

1. DOC 2.0
DIY Content Delivery and Feedback in Real-time

2. WEB EVOLUTION
Web Web 2.0 Web 3.0
Content Collaborative Ubiquitous
Search Social Semantic
Commerce Custom Personal

3. WEB 2.0
 Rich web/desktop applications -
AJAX, Flash, HTML5
 SOA - content syndication, mashups, RSS, WS
 Social web - collaborative authoring and content
filtering, relationships, conversations

6. DOC 2.0
 Rich web/desktop applications - Flash, HTML5, Air
 SOA - content syndication, mashups, instant
updates via RSS
 Social - collaborative
authoring, relationships, conversations

7. WORKFLOW
Get/Remix Deliver Socialize
RSS/Atom Integrate Sharing
Search/API Publish Rating
Convert/Filter Update Comments

8. GET/REMIX
 RSS/Atom feeds
 Mashups
 Google Search
 Twitter Search
 Yahoo Pipes

9. <?xml version="1.0" encoding="UTF-8" ?>
RSS <rss version="2.0">
<channel>
<title>Sample Feed</title>
 XML-based (.rss, .xml): <description> Some text </description>
<link>http://www.someexamplerssdomain.c
 Really Simple Syndication om/main.html</link>
<lastBuildDate>Mon, 06 Sep 2010
 RDF Site Summary 00:01:00 +0000 </lastBuildDate>
 “Frozen” at version 2.0 <pubDate>Mon, 06 Sep 2009 16:45:00
+0000 </pubDate>
 Does not allow to specify <item>
<title>Sample Item</title>
<description>Some text </description>
language context for
<link> http://example.org/20031203
individual items </link>
<guid> 60a76c80-d399-11d9-b91C</guid>
 Does not allows for non- <pubDate>Mon, 06 Sep 2009 16:45:00
+0000</pubDate>
ASCII characters in links and </item>
unique identifiers </channel>
</rss>

10. <?xml version="1.0" encoding="utf-8"?>
ATOM <feed
xmlns="http://www.w3.org/2005/Atom">
 XML-based (.atom, .xml): <title>Sample Feed</title>
<subtitle>Subtitle</subtitle>
 Atom Syndication Format <link href="http://example.org/feed"
rel="self" />
<link href="http://example.org" />
 Atom Publishing Protocol <id>urn:uuid:60a76c80-d399-11d9-b9</id>
<updated>2003-12-13T18:30:02Z</updated>
 Addresses shortcomings of <author>
<name>John Doe</name>
RSS <email>johndoe@example.com</email>
</author>
 Tags can be used in RSS 2.0 <entry>
<title>Sample Item</title>
<link
 Allows to specify language href="http://example.org/20031203" />
<id>urn:uuid:1225c695-cfb8-4ebb</id>
context for individual items <updated>2003-12-13T18:30:02Z</updated>
<summary>Some text</summary>
</entry>
 Allows for non-ASCII
</feed>
characters in links and unique
identifiers

11. MASHUPS
 Content/data aggregation:
 search and get data, text, images
 convert if needed
 translate if needed
 analyze content
 calculate frequencies and rankings
 delete repetitions
 output in desired format

12. MASHUP TOOLS
 Kapow Katalyst
 Yahoo Dapper
 RSSBus Data Providers
 MapBuilder
 Yahoo Pipes
 DataMashups.com
 ProgrammableWeb.com

13. GOOGLE SEARCH
 APIs:
 News (search results feed)
 BlogSearch (search results feed)
 Reader (page/site feed)
 Methods:
 GUI
 URL
 FeedBurner:
 subscription
 analytics

14. TWITTER SEARCH
 APIs:
 Basic Search
 Advanced Search
 Methods:
 GUI/URL
 Query parameters:
 words/phrases
 people
 places
 dates
 attitudes

15. YAHOO PIPES
 Features:
 free hosted online service
 private or public
 visual editor
 use, create, or clone/customize
 Remix:
 combine many feeds into one and sort/filter/translate
 geocode your favorite feeds and create interactive map
 copy/paste widgets/badges code for web site
 output in RSS, JSON, Atom, KML, and more

16. MODULES
 Sources - grab online data for processing
 User Inputs - manually enter parameters
 Operators - transform and filter data
 URL - manipulate URLs
 String - manipulate and combine strings
 Date - define and format dates.
 Location - convert strings to geo locations
 Number - use basic arithmetic operations

17. EXAMPLE: STEP 1

18. EXAMPLE: STEP 2

19. EXAMPLE: STEP 3

20. EXAMPLE: STEP 4

21. EXAMPLE: STEP 5

22. DELIVER
 Google widgets
 Twitter widgets
 Yahoo Pipes widgets
 CMS/WCMS/blog widgets
 FeedBurner
 TwitterFeed
 TwitterGrid
 Custom scripts
 RoboHelp AIR

23. SOCIALIZE
 Share
 Rate
 Comment

24. SHARE BUTTONS
 A way to increase traffic via organic distribution
 A method of audience self-selection
 Options:
 sharing services:
 catch-all buttons
 only-what-you-need buttons
 social media API
 custom development
 Sharing services:
 AddtoAny (most streamlined, Google Analytics)
 AddThis (very customizable, provides counts, analytics)
 ShareThis (very customizable, uses many services)

25. OPEN GRAPH API
 Social platforms are not about networks any more
 Any document becomes rich object in social graph
 Relatively simple
 Access user information
 Supply metadata, location information, contact
information, media type, etc.
 Specify object types:
activities, businesses, groups, organizations, peopl
e, places, products, websites
 Product information can include UPC or ISBN

26. FACEBOOK WIDGETS
 Like Button - lets users share pages to Facebook
profile with one click
 Send Button - allows users to send content to their
friends
 Comments - lets users comment on content
 Activity Feed - shows users what their friends are
doing on your site through likes and comments.
 Recommendations - gives users personalized
suggestions for content they might like
 Live Stream - lets users share activity and
comments in real-time

27. EXAMPLE: STEP 1
 Document URL
 Send Button
 Layout
(button, count, box)
 Size
 Faces
 Verb (like, recommend)
 Color scheme
(light, dark)
 Font

28. EXAMPLE: STEP 2
 Title
 Object type
 Your/business website
 Your logo/image
 Your/business name
 Administrators FB IDs

29. CUSTOM MIX-AND-MATCH
 Only-what-you-need buttons
 Associate content with your
social media accounts
 Choose service used
 Integrate with comments
 Collect your own
rating/counts data
 Customize data
 Customize style

30. Thank You!
Questions/comments:
mike@ucf.edu
Do not forget the evaluation forms!