Merge lp:~randall/uak/rr02 into lp:uak

[Randall Ross]

[Randall Ross (randall)]

review: Approve

=== modified file 'adk/adk-documentation.rst'
--- adk/adk-documentation.rst	2012-12-14 01:23:12 +0000
+++ adk/adk-documentation.rst	2012-12-19 22:10:25 +0000
@@ -1,9 +1,9 @@
-==========================
-Contributing Documentation
-==========================
+======================================
+Contributing Documentation to this Kit
+======================================
 
-A big chunk of the ADK is a fantastic set of documentation for how to advocate
-Ubuntu in different ways and how to join and create LoCo Teams. We want this
+A big chunk of the Ubuntu Advocacy Kit (UAK) is a fantastic set of documentation for how to advocate
+Ubuntu in different ways and how to join and create Ubuntu teams. We want this
 documentation to be clear, well written, and pleasurable to read.
 
 We are always looking for volunteers to help maintain our documentation and
@@ -25,7 +25,7 @@
 Inside the archive you can see an `adk` directory. This is where you can
 find the documentation.
 
-The content is writted in Restructured Text (RST); a simple way of applying formatting
+The content is writted in ReStructured Text (RST); a simple way of applying formatting
 and mark-up to content. As an example, this page is written in RST and you
 can read the source in `ubuntu-adk/adk/adk-documentation.rst` to see how it is
 written.
@@ -67,7 +67,7 @@
 With your content written, you need to format it to apply the headings, italics,
 boldface, bullet-points and other formatting elements.
 
-Content in the ADK is written using `reStructuredText <http://en.wikipedia.org/wiki/ReStructuredText>`_. This is a simple
+Content in the UAK is written using `reStructuredText <http://en.wikipedia.org/wiki/ReStructuredText>`_. This is a simple
 formatting style that lets you write your content and easily format it as you
 write it.
 
 
=== modified file 'adk/adk.rst'
--- adk/adk.rst	2012-12-14 01:23:12 +0000
+++ adk/adk.rst	2012-12-19 22:10:25 +0000
@@ -3,30 +3,29 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-About The ADK
+About The UAK
 =============
 
 
-The Ubuntu Advocacy Development Kit (ADK) kit is a collaborative project
-in the Ubuntu community designed to make it easier to share Ubuntu with others,
-create local communities, and advocate Ubuntu in your area and online.
-
-.. Tip:: If you find a problem in the ADK, such as broken pages, types, or
-	other issues, please `report it by clicking here <https://bugs.launchpad.net/ubuntu-adk/+filebug>`_.
-
-Contribute To The ADK
+The Ubuntu Advocacy Kit (UAK) kit is a collaborative project
+made by the Ubuntu community designed to make it easier to share the enthusiasm of Ubuntu with others, to create local communities of people that enjoy Ubuntu, and to advocate Ubuntu both in your local area and online.
+
+.. Tip:: If you find a problem in the UAK, such as broken pages, typos, or
+	any other issues, please `report it by clicking here <https://bugs.launchpad.net/ubuntu-adk/+filebug>`_.
+
+Contribute To The UAK
 ---------------------
 
-The aim of the ADK is to ensure we have clearly written, current, useful
-information and resources for Ubuntu advocacy.
+The aim of the UAK is to ensure we have clearly written, current, useful
+information and resources for Ubuntu advocates.
 
-To help keep the ADK up to date, we look to our community to contribute to
-it. If you can write documentation or translate, we have something you can
+To help keep the AUK up to date, we look to our community of Ubuntu enthusiasts worldwide to contribute to
+it. If you can write clear documentation or can translate our documents into your language, we have something you can
 help with!
 
-The goal of the ADK is to provide a comprehensive set of documentation and
+The goal of the UAK is to provide a comprehensive set of documentation and
 materials that our community can use to advocate Ubuntu as easily and
-effectively as possible.
+as effectively as possible.
 
 Ways To Help
 ~~~~~~~~~~~~
 
=== modified file 'adk/documentation.rst'
--- adk/documentation.rst	2012-12-17 13:16:37 +0000
+++ adk/documentation.rst	2012-12-19 22:10:25 +0000
@@ -1,10 +1,18 @@
-.. Advocacy Development Kit documentation master file, created by
+.. Ubuntu Advocacy Kit documentation master file, created by
    sphinx-quickstart on Wed Nov  7 17:33:41 2012.
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-LoCo Teams
-----------
+Tips for Ubuntu Advocates
+-------------------------
+
+.. toctree::
+   :maxdepth: 1
+
+   tips
+
+Ubuntu Local Community (LoCo) Teams
+-----------------------------------
 
 .. toctree::
    :maxdepth: 1
 
=== modified file 'adk/index.rst'
--- adk/index.rst	2012-12-14 20:43:28 +0000
+++ adk/index.rst	2012-12-19 22:10:25 +0000
@@ -1,32 +1,53 @@
 .. Advocacy Development Kit documentation master file, created by
    sphinx-quickstart on Wed Nov  7 17:33:41 2012.
    You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
+   contain the root `toctree` directive. (Recommend we refer to the kit (output) as simply "Ubuntu Advocacy Kit", and the thing that generates the kit as "Ubuntu Advocacy Development Kit". The word development has the potential to deter non-technical people that want to help us.)
+
+
 
 Welcome!
 ========
 
-Welcome to the **Ubuntu Advocacy Development Kit**!
-
-The Ubuntu Advocacy Development Kit (ADK) kit is designed to provide
-everything that you need to get started spreading the word about Ubuntu
-in your local community, online, and anywhere else.
-
-Included is a wealth of documentation and materials designed to ensure you
-have the content you need at your finger tips.
+Welcome to the **Ubuntu Advocacy Kit**!
+
+The Ubuntu Advocacy Kit (UAK) is an information resource written by people who are passionate about Ubuntu 
+and want to see Ubuntu spread everywhere. In short, we are Ubuntu Advocates. We want to change the world and we want you to help us.
+
+We have designed this kit to provide everything that you need to begin spreading the word about Ubuntu to 
+your friends, family, colleagues, your social networks, and even to random strangers on the street. 
+(Yes, we've done that too!)
+
+We have included wealth of helpful documentation and practical materials designed to ensure that you
+have everything you need at your finger tips. Never be at a loss for words about Ubuntu again. If you had 15 seconds to impress someone about Ubuntu, what would you say? What would you show?
+Always be ready to spread the concept of Ubuntu to those near you. And, do it in style!
+
+
+Are You an Ubuntu Advocate?
+---------------------------
+
+Chances are that by virtue of you taking the time to download and install this kit, you're likely an **advocate**,
+or nearly so.
+
+The dictionary defines an advocate as "A person who *publicly* supports or recommends a *particular* cause or policy." The key words are "publicly" and "particular". 
+
+Do you say good things about Ubuntu in public? Do you want to?
+
+Do you enjoy Ubuntu regularly? Do you contribute to spreading the project? Do you get passionate when talking to others about 
+Ubuntu? Do you envision a world where people have a say in their computing tools and where the tools work for them? That's freedom!
+
+Welcome to the world of Ubuntu advocacy. You are amongst friends.
+
 
 Who Is This Kit For?
 --------------------
 
 This kit is designed for *anyone* who wants to advocate, share, and spread
-the word about Ubuntu.
-
-Although many people gather together in LoCo Teams to advocate Ubuntu together,
-you *don't have to join a LoCo Team* to help advocate Ubuntu. We typically
-recommend joining a LoCo Team as it can be a lot of fun, but it is certainly
-not a requirement.
-
-If you want to share Ubuntu with others, this kit is for you!
+the word about Ubuntu. In short: *Advocates*
+
+Although many people gather together in Ubuntu local community (LoCo) Teams to advocate Ubuntu together,
+you *don't have to join an Ubuntu local community (LoCo) Team* to help advocate Ubuntu or to benefit from (or contribute to) this kit. Joining a LoCo Team *can* be a lot of fun, but it is certainly not a requirement.
+
+If you want to share your enthusiasm about Ubuntu with others, this kit is for *definitely* for you!
 
 Navigating The Kit
 ------------------
@@ -36,7 +57,7 @@
 
  * `Documentation <./documentation.html>`_ - a wide range of guidance, information
 	and expertise about how to advocate Ubuntu and spread the word, and how to
-	join, create, and organize Ubuntu LoCo Teams.
+	join, create, and organize Ubuntu Local Community (LoCo) Teams.
  * `Materials <./materials.html>`_ - a wide range of high-quality logos, posters,
 	and other content available at your finger tips to perform your advocacy
 	with.
 
=== modified file 'adk/locoteams-activities.rst'
--- adk/locoteams-activities.rst	2012-12-12 02:20:55 +0000
+++ adk/locoteams-activities.rst	2012-12-19 22:10:25 +0000
@@ -2,12 +2,12 @@
 Activities For LoCo Teams
 =========================
 
-Things your LoCo can do
+Things Your Team Can Do
 =======================
 
-LoCo teams are predominantly set up to do interesting things such as advocacy,
-education, support, translations or other tasks. You should always have tasks
-available for members to get started with, and try to have a varied enough
+Ubuntu Local Community (LoCo) teams are predominantly set up to bring people that share an enjoyment of Ubuntu together. They do interesting and enjoyable things such as advocacy,
+education, support, translations, coding, or many other activities. Teams needn't be all task-oriented all the time though. Sometimes, people just want to hang out and talk about Ubuntu with other people that enjoy Ubuntu. That is ok! You should always have a balance of fun. You should also have tasks
+available for members to get started with contibuting to Ubuntu, and try to have a varied enough
 list of tasks that anyone can get involved, no matter what their interest
 is. Here are some suggestions.
 
 
=== modified file 'adk/locoteams-creating.rst'
--- adk/locoteams-creating.rst	2012-12-18 03:54:52 +0000
+++ adk/locoteams-creating.rst	2012-12-19 22:10:25 +0000
@@ -1,16 +1,22 @@
-====================
-Creating a LoCo Team
-====================
-
-Creating a LoCo team is an exciting, challenging and rewarding experience.
-
-With a successful LoCo team you have the potential to really help advocate
-and develop Ubuntu in your part of the world and get more people using Free Software.
-
-Although from the outset, setting up a LoCo seems simple, getting a successful
-team up and running can often be a challenging, difficult process. Running
-a LoCo team not only requires a skill in motivating people to join your team,
-but it also requires an ability to inspire the team where to move forward,
+===============================
+Creating a Local Community Team
+===============================
+
+Creating a local community (LoCo) team is an exciting, challenging and a potentially rewarding experience.
+
+With a successful team you have the potential to really help advocate
+and develop Ubuntu in your part of the world and to get more people enjoying Free Software.
+
+Do You Have "The Right Stuff"?
+==============================
+
+Do you enjoy meeting new people? Do you enjoy a room filled with lively conversations and fun? Do you feel happy when you introduce two total strangers to one another who didn't know they had much in common in the first place? You might be a connector. 
+
+* We should talk about some standard roles here. The "hunter", the "farmer", the "manager", etc.
+
+Although from the outset, setting up a team seems simple, getting a successful
+team up and running can sometimes be a challenging, and difficult process. Running a LoCo team not only requires a skill in motivating people to join your team,
+but also ability to inspire the team where to move forward,
 be organised and resolve conflict where required. Setting up and leading
 a LoCo team is not about forming a group and telling people what to do -
 it is about forming a group and inspiring people to do amazing things.
@@ -18,17 +24,26 @@
 Getting Started
 ===============
 
-When deciding to create a LoCo team for your area, you should first decide
-which particular region you want to create a team for. Before you continue,
-first check to see if an existing team exists. See the `full list of LoCo Teams <http://loco.ubuntu.com/teams/>`_
-and look to see if there is one in your area.
-
-Generally LoCo teams have a fairly large catchment area. So, as an example
-the UK LoCo Team have a single group for the entire country. This is because
-the UK is a fairly small country. However, as part of the UK Team, smaller
-meetings around the country happen, but they all fall under the remit of
-the UK LoCo team. For larger countries such as the USA, it is more common
-to have LoCo teams at a state level - the country is too big to have one single LoCo team.
+So, you think you have what it takes to make an Ubuntu team in your area? Great!
+
+When deciding to create a team near you, you should first decide
+which particular geography you want to create a team for. Generally, you'll want your team to be in close enough proximity to be able to meet without a big hassle of getting to and from events. 
+
+You'll also want to ensure that your team encompasses a large enough population to reach a critical mass of regular participants. As a rule of thumb, if you take the population of your town and divide by 200, you'll get an idea of how many people are likely already Ubuntu people. (This varies widely by region though, so if you get a lot more or less, don't blame us). Of the total number of people that enjoy Ubuntu in your town or city, likely 1 in 10 are what we call "joiners". People that like to join organized Ubuntu teams.
+
+Before you continue,
+you might first want to check to see if a team exists in your town or city. You can see the `full list of LoCo Teams <http://loco.ubuntu.com/teams/>`_
+
+
+Note that historically, Ubuntu was a small project and as a side-effect LoCo teams have had to have a fairly large catchment area. For example,
+the United Kingdom (UK) LoCo Team have a single group for the entire country. This is because
+the UK is a fairly (geographically) small country. However, as Ubuntu has grown, 
+meetings in towns and cities around the country happen, all loosely affiliated with the UK LoCo team. For larger countries such as the USA, it has been more common
+to have LoCo teams at a state level - the country is far too vast to to have one single LoCo team. Imagine having to travel from Seattle to Miami to attend an Ubuntu release party! ;) And in some (rarer) cases, LoCo teams exist at a city or town level (e.g. Vancouver, Chicago, )
+
+
+
+* RR: The below text is sounding bureaucratic and I recommend we consider spinning it out of the advocacy kit, or re-work it significantly. 
 
 Each LoCo team is intended to support all variants of Ubuntu/Kubuntu/Edubuntu
 etc. If you want to set up a specific group for a derivative, you should do
 
=== added file 'adk/tips.rst'
--- adk/tips.rst	1970-01-01 00:00:00 +0000
+++ adk/tips.rst	2012-12-19 22:10:25 +0000
@@ -0,0 +1,48 @@
+Tips For Ubuntu Advocates
+-------------------------
+
+We've seen a lot of people try to advocate Ubuntu over the years. Some of their efforts fail, even though Ubuntu is an impressive project. Here are some "words of wisdom" based on what we've seen work:
+
+1.  **Pronounce "Ubuntu" correctly.** It's pronounced “Oo-boon-too”. This 
+might sound like something trivial or pedantic, but please recognize 
+that when you mispronounce a word, your credibility may be called into question.
+
+2.  **Use Ubuntu yourself. Every day.** Make it your sole operating system and
+immerse yourself in it. After all, if you're not confident enough to do so, why should anyone else? 
+As Gandhi once said, “Be the change you want to see.”
+
+3.  **Don't assume people have ever heard of it.** Pretend it's brand new to them. 
+Introduce Ubuntu as Ubuntu, and skip the references to arcane systems of days gone by, 
+and also skip the computer science minutia. Most people don't care and tend to tune out
+if you try to impress with jargon or recount a technical history lesson.
+
+4.  **Choose your targets.** Don't assume that everyone is ready for Ubuntu. Some aren't. 
+Since you have limited resources and time, try to gauge whether a person is receptive 
+to new ideas and ways of thinking, generally. Ask them some probing questions (without 
+saying Ubuntu) that will help you understand their comfort with change. If they seem to 
+be open-minded, give it a shot.
+
+5.  **Don't be a soloist.** You're not the whole Ubuntu community. The millions of people in 
+the world who use Ubuntu collectively have a much greater wealth of Ubuntu knowledge than 
+yourself individually. So, if you've found someone that you think is ready for Ubuntu, 
+encourage them to participate in the community as their next step. There's no substitute 
+for a community and the person you guide way will be richer in knowledge because you have 
+done so.
+
+6.  **Learn about Ubuntu and know it well.** If you don't know something, defer to the Ubuntu
+community. Someone out there will know it. Don't make up answers. 
+
+7.  **Always be prepared** to give a brief but interesting demo. Have a good, clean working system 
+running the latest released version of Ubuntu. Ideally, you'll want a separate user on your system called “demo” 
+or something similar set up so you're not exposing personal files or strange configurations and settings 
+that will confuse your target audience. Encourage them to play with the system themselves.
+
+8.  **Never compare Ubuntu** with other operating systems, free or not. When you do, you draw people's 
+attention away from your message and towards a competitor's. Don't name competitors' names. Refer to their 
+products only if asked specifically, and only in the general sense.
+
+9.  **Use stories.** People appreciate a good story about your personal journey. How did you discover 
+Ubuntu? What impressed you the most about it? When did you make the decision to never turn back? 
+Even though these tips will likely steer you in a good direction in your advocacy efforts, never forget 
+that there are no universal strategies. Every person you approach will need a slightly different
+flavour of the above.
 \ No newline at end of file