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

[Randall Ross]

Included tips for advocates.
Major rewrite of locoteams-activities.

[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	2013-01-22 17:13:20 +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	2013-01-22 17:13:20 +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	2013-01-22 17:13:20 +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	2013-01-22 17:13:20 +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	2013-01-22 17:13:20 +0000
@@ -1,15 +1,65 @@
-=========================
-Activities For LoCo Teams
-=========================
+================================
+Activities For Ubuntu 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
-list of tasks that anyone can get involved, no matter what their interest
-is. Here are some suggestions.
+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. Sometimes they just want to have a social gathering at a local restaurant or coffee shop. Maybe they just want to have a party to celebrate Ubuntu. That is ok too! Ubuntu is not always about code, or work. Stated another way, "Ubuntu is not just software."
+
+You should always strive to have a healthy balance of fun activities. 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 interests or skill levels are. Here are some suggestions.
+
+Create Fun Events for People to Enjoy
+-------------------------------------
+
+What brings people together? And no, we're not talking about what brings "techies" together. We really do mean *everyone*. Here are some examples of events that are social in nature and have broad appeal, like Ubuntu.
+
+a) Coffee Chats:
+Most people enjoy the ambience of a local coffee shop and like to make connections with others that share their interests. Try organizing a gathering at your favourite coffee shop and see who comes out. You'll likely find some Ubuntu people, and even if not, you'll be spreading awareness of the project in your neighbourhood. All it takes is a friendly owner (of the shop), a small professional-looking sign for a table or two and a couple hours of your time. We often call these events "Ubuntu Hours", or something catchy like "A Cup of Ubuntu". Don't forget to take pictures.
+
+b) Restaurant Socials:
+When was the last time you had a great meal at a restaurant surrounded by friends? How many of them enjoy Ubuntu? Well, imagine for a moment you're at your favourite neighbourhood restaurant surrounded by *dozens* of people that enjoy Ubuntu. It's not that hard to do! A friendly restauranteur will gladly reserve some tables for an Ubuntu gathering. The key to this type of event is to keep costs reasonable so everyone can join in, and to try to pick days when restaurants are slow so you're not waiting or making it harder for your hosts. In many cities, Tuesdays are slow restaurant nights. Maybe call your event "Treat Tuesday" to grab people's attention.
+
+c) Barbecues & Picnics:
+If you're fortunate enough to live in a place that has great weather, a barbecue/picnic is a fun way to bring people together. Reserve a picnic space at a local park, bring some food and invite others to do the same. If you're really clever, have balloons, signs and banners that will help people find you and will show people who aren't enjoying Ubuntu all the fun they could be having. Invite a musician or two to make things really interesting.
+
+d) Parties!
+Everyone loves a great party! Well, almost everyone. Why not throw one in celebration of Ubuntu? What makes a party fun? Good people, good music, entertainment, food, drinks, a theme and a festive atmosphere. You can invite people from your city to come and celebrate even if (or especially if) they've never heard of Ubuntu. Keep it fun and leave the computers at home. You'll be surprised how much excitement you can generate this way.
+
+
+
+Make Ubuntu Visible in Your City
+--------------------------------
+
+How many people in your city have heard of Ubuntu? One of the biggest hurdles we face to mass adoption is a lack of awareness amongst the general public. Here's something to try: If you ask 100 random people on a busy street corner to tell you what Ubuntu is, how many correct answers do you get? (We've actually tried this and it's quite enlightening.)
+
+You have the capability to change the awareness level of Ubuntu in your city directly. Think of all the busy places in your city and how to get Ubuntu noticed there. For example:
+
+1) Flyers & Stickers: Some teams make small flyers or stickers that can be posted in public places like libraries, bulletin boards and even on public poles (check regulations though.) People are intrigued when they see something new and may look it up to see what it means.
+
+2) Parades: Teams have joined large parades and walked in bright orange colours waving Ubuntu banners.
+
+3) Street teams: Gather some of your Ubuntu friends together. Dress in Ubuntu colours and hit a busy street talking to people. Bring some business cards that point to your local Ubuntu group to let people know they can always come and learn more.
+
+4) Public markets: Many cities have public places where goods are bought and sold (e.g. farmers markets). You can get a small table at an upcoming market and give away information about Ubuntu to people.
+
+5) Stunts: Though these involve more planning (and sometimes even money), you can do interesting marketing stunts like painting murals, chalking sidewalks, painting cars in the Ubuntu colours, even shaving heads in the Ubuntu logo pattern... the only limit is your imagination.
+
+6) Conferences and Trade Shows: Get a booth at a local conference and provide information about Ubuntu. Let attendees know that there's a vibrant Ubuntu community in your city. (This works best at shows that have little or no FLOSS people in attendance. Otherwise you'll likely just be "preaching to the choir.")
+
+
+Create Ubuntu
+-------------
+
+Provide Community-Based Support
+-------------------------------
+
+Build a Network of People that Love Ubuntu
+------------------------------------------
+
+
 
 Get your LoCo working with area GLUGs
 -------------------------------------

=== modified file 'adk/locoteams-creating.rst'
--- adk/locoteams-creating.rst	2012-12-18 03:54:52 +0000
+++ adk/locoteams-creating.rst	2013-01-22 17:13:20 +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
@@ -128,7 +143,7 @@
 
 If you want to log the channel, which is recommended for IRC meetings, you
 should contact the ubuntu-EU admin team (at [e-mail]) to get
-a LoCoBot (a bot on irc.freenode.net). Ask them to add your channel to the list.
+a LoCoBot (a bot on irc.freenode.org). Ask them to add your channel to the list.
 
 See also:
 
@@ -199,7 +214,7 @@
 Add Your Team To The LoCo Portal
 ================================
 
-The `LoCo Portal <http://loco.ubuntu.com>`_ is where we list community teams.
+The `LoCo Portal <http://loco.ubuntu.com>`) is where we list community teams.
 
 To get your new team listed, first make sure your team is a member of
 https://launchpad.net/~locoteams.

=== added file 'adk/tips.rst'
--- adk/tips.rst	1970-01-01 00:00:00 +0000
+++ adk/tips.rst	2013-01-22 17:13:20 +0000
@@ -0,0 +1,45 @@
+Tips For Ubuntu Advocates
+-------------------------
+
+We've seen a lot of people try to advocate Ubuntu over the years. Even though Ubuntu is an impressive project, some advocacy efforts fail. Here are some "words of wisdom" based on what we've seen actually work:
+
+1.  **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 be? As Mahatma Gandhi once said, “You must be the change you want to see in the world.”
+
+2.  **Don't assume people have ever heard of Ubuntu.** 
+
+Pretend it's brand new to them. Introduce Ubuntu simply 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 will tend to tune out if you try to impress them with jargon or recount a technical history lesson.
+
+3.  **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, it can have a discrediting effect. Still not convinced? Think of when you learned a foreign language. Did you try to pronounce those words as a native speaker would? Of course you did! A quick Google search for the correct pronunciation (Desmond Tutu and Nelson Mandela are good examples) and a few minutes of practice is all it takes to master the correct pronunciation.
+
+4.  **Choose your targets wisely.** 
+
+Don't assume that everyone is ready for Ubuntu. Some people 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, before exerting your energy. Ask them some probing questions (without saying Ubuntu) that will help you understand their comfort with and readiness for change. If they seem to be open-minded, give it a shot. If not, move along. We'll come back for them later.
+
+5.  **Don't be a soloist.** 
+
+You're not the whole Ubuntu community. The hundreds thousands of people in your city who enjoy Ubuntu collectively have a much greater wealth of Ubuntu knowledge than yourself individually will ever have. So, if you've found someone that you think is ready for Ubuntu, encourage them to participate in the local Ubuntu community in your city as their first step. Help them find people in your city that also enjoy Ubuntu. There's really no substitute for a face-to-face Ubuntu community and the person you guide towards it will be richer in knowledge because you have done so.
+... And, you'll be able to spend more time finding the next advocate rather than installing Ubuntu or solving tech issues!
+
+6.  **Never compare Ubuntu.** 
+
+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 (even if a friendly one). You also frame Ubuntu in their context, which is usually "just software". Don't name competitors' names. Refer to their products only if asked specifically, and only in the general sense. And if this happens, keep steering your conversation back to Ubuntu. If you do this, you'll be able to spend more time spreading enthusiasm about Ubuntu rather than re-hashing nightmarish experiences with other systems...
+
+7.  **Learn about Ubuntu and know it well.** 
+
+Learn about Ubuntu (the product) and become proficient at it. Learn what all the pieces in the user interface (UI) are officially called. Learn what makes Ubuntu unique. What are its "crown jewels?" Look for the exciting pieces that differentiate it from other systems and learn those inside-out. This part is important: If you are asked something specific about Ubuntu and you don't know the answer, say so. Even better, defer to the Ubuntu community, preferably the one in your city. Someone out there will know it. Don't make up answers. If you do this, you'll be able to speak with confidence and your enthusiasm for Ubuntu will spread.
+
+8.  **Tell interesting stories.** 
+
+People appreciate a good story about your personal journey. How did you first discover Ubuntu? What impressed you the most about it? When did you make the decision to never turn back? How did you feel the first time you met Mark Shuttleworth? What was your first UDS like? Talk about all the great people you've met as a result of your involvement in this project. Talk about how you are helping to change the world. Let your passion show. 
+
+9.  **Give great demos.** 
+
+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 (with no admin privileges) 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. Tell them they can't break it. Let them explore. If you do this, people will see the magic themselves. 
+
+10. **Resist the change resistors.**
+
+Ubuntu is a wildly transformational project. In technology circles this is called a "disruption". (Note that Ubuntu transcends technology boundaries and extends to society.) With any substantially disruptive project there will be people along the way that want to maintain the status quo, and by extension do not want Ubuntu to spread. One might say "they like their world just the way it is." And, believe it or not, even within the Ubuntu project itself there can sometimes be resistance to change (e.g. to adapting Ubuntu's code and processes to make crossing the chasm possible). Have you encountered resistors? How did it make you feel? Do you have an actionable idea that will help Ubuntu to spread? Don't heed the nay-sayers. Resist the change-resistors and Just DO IT!