Another run-through on the post!

Author: weaverryan

collaboration.rst

@@ -1,32 +1,51 @@
-Collaboration in the world of Tutorials
-=======================================
+The Collaboration Machine of the Docs World
+===========================================
 
-You love open source software, right?
+We all love and depend on open source software.
 
-What about open source content?
+But what about open source content?
 
-We're now in a software Rennaisance. Open Source Software and tools like
-GitHub let us work together brilliantly. The result is huge gains in quality
-and innovation. That's really important.
+Open Source Software and tools like GitHub let us work together brilliantly.
+The result is huge gains in quality and innovation. That's really important.
 
 But content - the documentation, tutorials and books that teach us about all
 of this tech - is behind the curve. Yes, official documentation is usually
-on a GitHub repository and we see a huge community effort with the
-`Symfony documentation`_. Even StackOverlow is an example of crowd-sourcing
-the information-side of tech. But mostly, books, blog posts and everything in
-between are still written by one person. They sit, slowly rot with time,
-and are eventually forgotten. New books are written by new authors from scratch.
-The cycle continues.
+on a GitHub repository and we see a **huge** community effort with the
+`Symfony documentation`_ (nod to `@WouterJ`_ - pronounced Wow!ter). Even
+StackOverlow is an example of crowd-sourcing the information-side of tech.
+But mostly, books, blog posts and everything in between are still written
+by one person. They sit, slowly rot with time, and are eventually forgotten.
+New books are written by new authors from scratch. The cycle continues. We're
+all part of it.
 
 This cycle is an antique. And like most things that move slowly, the Internet
-will fix this. Imagine a world where tutorials are based on real, high-quality
-projects written by many people. That's where I want to go.
+will correct this. Imagine a world where tutorials are based on real, high-quality
+projects written by many people and evolving over time. That's where I want
+to be.
 
-Colaboration Now
-----------------
+Making Content Editable
+-----------------------
 
-So, how can we push this forward? We're starting by (being really lucky to)
-collaborate with some brilliant people:
+More and more blogs are using GitHub-backed repositories, and although there
+isn't a culture (yet) of contributing like we do to code, I think it's inevitable.
+
+Our screencast and blog content is also open source and lives up on `GitHub`_.
+That's actually not new, but the **"Edit"** button at the top of this page
+and the contributers on the right *is* new. Get your avatar up there and
+push the culture of docs contributing by PR'ing some content. I even left
+a typo in this paragraph (though there's probably more on the page). Find it!
+
+Reading from the Shoulders of Giants
+------------------------------------
+
+Often there are topics I need to learn and a person that I know could build
+a *perfect* tutorial to teach me. For that reason, I've started humbly asking
+really smart (and busy) people to help write future tutorials: they bring
+expertise, we hopefully help with a lot of the not-so-fun work (writing,
+editing, video recording, etc).
+
+We're starting by (being really lucky to) collaborate with some brilliant
+people:
 
 * `Brent Shaffer`_ is our partner for the `OAuth 2.0 in 8 Steps`_ tutorial.
   In addition to being our mega-expert, he drew us `ridiculous farming pictures`_.
@@ -35,36 +54,34 @@ collaborate with some brilliant people:
   This is amazing, because it means having a real-world tutorial written
   by one of the leaders in building technology that helps make RESTy sites.
 
-.. info::
-
-    And if you're great at something, we want to bring your knowledge to
-    life too. Comment here or bother us on `Twitter`_.
-
-What else?
-
-Our screencast and blog content is also open source and lives up on `GitHub`_.
-That's actually not new, but the "Edit" button at the top of this page and
-the contributors on the right *is* new. Do us all a favor and get your face
-up on the site. I even left a typo in this paragraph (though there's probably
-on the page). Find it!
+And if you're great at something and I haven't already bothered you - ping
+us on `Twitter`_ or comment here. I want to bother you :).
 
 Why Don't we all Write More?
 ----------------------------
 
-If the problem is ultimately that we all need write more, then why don't
-we? What stops us from all writing tutorials? Here are some reasons I think:
+If the problem is ultimately that we should all write more (and collaborate),
+then why don't we? What stops us from writing the tutorials we wish existed?
+I'd genuinely like to hear from you (again, comments!).
 
-- There's nowhere easy to publish it (same as blog posts) - not true for everyone;
+Here are some reasons *I* think, which could be totally wrong:
+
+- There's nowhere easy to publish it (this is not true for everyone);
 
 - It's way more fun to just write code;
 
-- A tutorial and code are disconnected - I need to write an app and *then*
-  go back and write it all. I'll have  to copy code into the tutorial, which
-  may be wrong or get outdated.
+- There's nobody coordinating collaboration;
+
+- A tutorial and its code are disconnected - I need to write an app and *then*
+  go back and document the steps. I'll have to copy code into the tutorial,
+  which may be wrong or get outdated.
 
-Are these right? Wrong? What stops you from writing a tutorial?
+Right? Wrong? What stops you from writing a tutorial?
 
 Code collaboration blew up when GitHub made the process easy and rewarding.
-I hope we can help do the same for tutorials. Stay tuned. 
+I hope we can help do the same for tutorials... and include everone on the
+process.
 
 <3 Ryan
+
+.. _`@WouterJ`: https://twitter.com/wouterjnl

metadata.yml

@@ -78,12 +78,13 @@ blogs:
         category: symfony
 
     "collaboration":
-        title: Collaboration in the world of Tutorials
-        published: 2014-01-27
+        title: The Collaboration Machine of the Docs World
+        published: 2014-02-04
         preview: |
-            I love writing and recording tutorials. But I'm a lot more excited
-            about the possibility of collaborating with a big community. We
-            work together on our open source software, and it's 'inevitable
-            that we'll do the same with tutorials. That's what gets me excited.
+            Collaboration on software is *huge*, and we all enjoy the benefits.
+            So why don't we see more with documentation? I'll tell you where
+            I think tutorials & collaboration are going and what prevents
+            us from getting there. But I also want to know what keeps *you*
+            from writing tutorials and collaborating.
         author: weaverryan
         category: news