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

Proposed by Randall Ross
Status: Merged
Approved by: Randall Ross
Approved revision: 65
Merged at revision: 100
Proposed branch: lp:~randall/uak/rr02
Merge into: lp:uak
Diff against target: 348 lines (+162/-71)
7 files modified
adk/adk-documentation.rst (+7/-7)
adk/adk.rst (+14/-15)
adk/documentation.rst (+11/-3)
adk/index.rst (+39/-18)
adk/locoteams-activities.rst (+4/-4)
adk/locoteams-creating.rst (+39/-24)
adk/tips.rst (+48/-0)
To merge this branch: bzr merge lp:~randall/uak/rr02
Reviewer Review Type Date Requested Status
Randall Ross Approve
Review via email: mp+140778@code.launchpad.net
To post a comment you must log in.
Revision history for this message
Randall Ross (randall) :
review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'adk/adk-documentation.rst'
2--- adk/adk-documentation.rst 2012-12-14 01:23:12 +0000
3+++ adk/adk-documentation.rst 2012-12-19 22:10:25 +0000
4@@ -1,9 +1,9 @@
5-==========================
6-Contributing Documentation
7-==========================
8+======================================
9+Contributing Documentation to this Kit
10+======================================
11
12-A big chunk of the ADK is a fantastic set of documentation for how to advocate
13-Ubuntu in different ways and how to join and create LoCo Teams. We want this
14+A big chunk of the Ubuntu Advocacy Kit (UAK) is a fantastic set of documentation for how to advocate
15+Ubuntu in different ways and how to join and create Ubuntu teams. We want this
16 documentation to be clear, well written, and pleasurable to read.
17
18 We are always looking for volunteers to help maintain our documentation and
19@@ -25,7 +25,7 @@
20 Inside the archive you can see an `adk` directory. This is where you can
21 find the documentation.
22
23-The content is writted in Restructured Text (RST); a simple way of applying formatting
24+The content is writted in ReStructured Text (RST); a simple way of applying formatting
25 and mark-up to content. As an example, this page is written in RST and you
26 can read the source in `ubuntu-adk/adk/adk-documentation.rst` to see how it is
27 written.
28@@ -67,7 +67,7 @@
29 With your content written, you need to format it to apply the headings, italics,
30 boldface, bullet-points and other formatting elements.
31
32-Content in the ADK is written using `reStructuredText <http://en.wikipedia.org/wiki/ReStructuredText>`_. This is a simple
33+Content in the UAK is written using `reStructuredText <http://en.wikipedia.org/wiki/ReStructuredText>`_. This is a simple
34 formatting style that lets you write your content and easily format it as you
35 write it.
36
37
38=== modified file 'adk/adk.rst'
39--- adk/adk.rst 2012-12-14 01:23:12 +0000
40+++ adk/adk.rst 2012-12-19 22:10:25 +0000
41@@ -3,30 +3,29 @@
42 You can adapt this file completely to your liking, but it should at least
43 contain the root `toctree` directive.
44
45-About The ADK
46+About The UAK
47 =============
48
49
50-The Ubuntu Advocacy Development Kit (ADK) kit is a collaborative project
51-in the Ubuntu community designed to make it easier to share Ubuntu with others,
52-create local communities, and advocate Ubuntu in your area and online.
53-
54-.. Tip:: If you find a problem in the ADK, such as broken pages, types, or
55- other issues, please `report it by clicking here <https://bugs.launchpad.net/ubuntu-adk/+filebug>`_.
56-
57-Contribute To The ADK
58+The Ubuntu Advocacy Kit (UAK) kit is a collaborative project
59+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.
60+
61+.. Tip:: If you find a problem in the UAK, such as broken pages, typos, or
62+ any other issues, please `report it by clicking here <https://bugs.launchpad.net/ubuntu-adk/+filebug>`_.
63+
64+Contribute To The UAK
65 ---------------------
66
67-The aim of the ADK is to ensure we have clearly written, current, useful
68-information and resources for Ubuntu advocacy.
69+The aim of the UAK is to ensure we have clearly written, current, useful
70+information and resources for Ubuntu advocates.
71
72-To help keep the ADK up to date, we look to our community to contribute to
73-it. If you can write documentation or translate, we have something you can
74+To help keep the AUK up to date, we look to our community of Ubuntu enthusiasts worldwide to contribute to
75+it. If you can write clear documentation or can translate our documents into your language, we have something you can
76 help with!
77
78-The goal of the ADK is to provide a comprehensive set of documentation and
79+The goal of the UAK is to provide a comprehensive set of documentation and
80 materials that our community can use to advocate Ubuntu as easily and
81-effectively as possible.
82+as effectively as possible.
83
84 Ways To Help
85 ~~~~~~~~~~~~
86
87=== modified file 'adk/documentation.rst'
88--- adk/documentation.rst 2012-12-17 13:16:37 +0000
89+++ adk/documentation.rst 2012-12-19 22:10:25 +0000
90@@ -1,10 +1,18 @@
91-.. Advocacy Development Kit documentation master file, created by
92+.. Ubuntu Advocacy Kit documentation master file, created by
93 sphinx-quickstart on Wed Nov 7 17:33:41 2012.
94 You can adapt this file completely to your liking, but it should at least
95 contain the root `toctree` directive.
96
97-LoCo Teams
98-----------
99+Tips for Ubuntu Advocates
100+-------------------------
101+
102+.. toctree::
103+ :maxdepth: 1
104+
105+ tips
106+
107+Ubuntu Local Community (LoCo) Teams
108+-----------------------------------
109
110 .. toctree::
111 :maxdepth: 1
112
113=== modified file 'adk/index.rst'
114--- adk/index.rst 2012-12-14 20:43:28 +0000
115+++ adk/index.rst 2012-12-19 22:10:25 +0000
116@@ -1,32 +1,53 @@
117 .. Advocacy Development Kit documentation master file, created by
118 sphinx-quickstart on Wed Nov 7 17:33:41 2012.
119 You can adapt this file completely to your liking, but it should at least
120- contain the root `toctree` directive.
121+ 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.)
122+
123+
124
125 Welcome!
126 ========
127
128-Welcome to the **Ubuntu Advocacy Development Kit**!
129-
130-The Ubuntu Advocacy Development Kit (ADK) kit is designed to provide
131-everything that you need to get started spreading the word about Ubuntu
132-in your local community, online, and anywhere else.
133-
134-Included is a wealth of documentation and materials designed to ensure you
135-have the content you need at your finger tips.
136+Welcome to the **Ubuntu Advocacy Kit**!
137+
138+The Ubuntu Advocacy Kit (UAK) is an information resource written by people who are passionate about Ubuntu
139+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.
140+
141+We have designed this kit to provide everything that you need to begin spreading the word about Ubuntu to
142+your friends, family, colleagues, your social networks, and even to random strangers on the street.
143+(Yes, we've done that too!)
144+
145+We have included wealth of helpful documentation and practical materials designed to ensure that you
146+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?
147+Always be ready to spread the concept of Ubuntu to those near you. And, do it in style!
148+
149+
150+Are You an Ubuntu Advocate?
151+---------------------------
152+
153+Chances are that by virtue of you taking the time to download and install this kit, you're likely an **advocate**,
154+or nearly so.
155+
156+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".
157+
158+Do you say good things about Ubuntu in public? Do you want to?
159+
160+Do you enjoy Ubuntu regularly? Do you contribute to spreading the project? Do you get passionate when talking to others about
161+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!
162+
163+Welcome to the world of Ubuntu advocacy. You are amongst friends.
164+
165
166 Who Is This Kit For?
167 --------------------
168
169 This kit is designed for *anyone* who wants to advocate, share, and spread
170-the word about Ubuntu.
171-
172-Although many people gather together in LoCo Teams to advocate Ubuntu together,
173-you *don't have to join a LoCo Team* to help advocate Ubuntu. We typically
174-recommend joining a LoCo Team as it can be a lot of fun, but it is certainly
175-not a requirement.
176-
177-If you want to share Ubuntu with others, this kit is for you!
178+the word about Ubuntu. In short: *Advocates*
179+
180+Although many people gather together in Ubuntu local community (LoCo) Teams to advocate Ubuntu together,
181+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.
182+
183+If you want to share your enthusiasm about Ubuntu with others, this kit is for *definitely* for you!
184
185 Navigating The Kit
186 ------------------
187@@ -36,7 +57,7 @@
188
189 * `Documentation <./documentation.html>`_ - a wide range of guidance, information
190 and expertise about how to advocate Ubuntu and spread the word, and how to
191- join, create, and organize Ubuntu LoCo Teams.
192+ join, create, and organize Ubuntu Local Community (LoCo) Teams.
193 * `Materials <./materials.html>`_ - a wide range of high-quality logos, posters,
194 and other content available at your finger tips to perform your advocacy
195 with.
196
197=== modified file 'adk/locoteams-activities.rst'
198--- adk/locoteams-activities.rst 2012-12-12 02:20:55 +0000
199+++ adk/locoteams-activities.rst 2012-12-19 22:10:25 +0000
200@@ -2,12 +2,12 @@
201 Activities For LoCo Teams
202 =========================
203
204-Things your LoCo can do
205+Things Your Team Can Do
206 =======================
207
208-LoCo teams are predominantly set up to do interesting things such as advocacy,
209-education, support, translations or other tasks. You should always have tasks
210-available for members to get started with, and try to have a varied enough
211+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,
212+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
213+available for members to get started with contibuting to Ubuntu, and try to have a varied enough
214 list of tasks that anyone can get involved, no matter what their interest
215 is. Here are some suggestions.
216
217
218=== modified file 'adk/locoteams-creating.rst'
219--- adk/locoteams-creating.rst 2012-12-18 03:54:52 +0000
220+++ adk/locoteams-creating.rst 2012-12-19 22:10:25 +0000
221@@ -1,16 +1,22 @@
222-====================
223-Creating a LoCo Team
224-====================
225-
226-Creating a LoCo team is an exciting, challenging and rewarding experience.
227-
228-With a successful LoCo team you have the potential to really help advocate
229-and develop Ubuntu in your part of the world and get more people using Free Software.
230-
231-Although from the outset, setting up a LoCo seems simple, getting a successful
232-team up and running can often be a challenging, difficult process. Running
233-a LoCo team not only requires a skill in motivating people to join your team,
234-but it also requires an ability to inspire the team where to move forward,
235+===============================
236+Creating a Local Community Team
237+===============================
238+
239+Creating a local community (LoCo) team is an exciting, challenging and a potentially rewarding experience.
240+
241+With a successful team you have the potential to really help advocate
242+and develop Ubuntu in your part of the world and to get more people enjoying Free Software.
243+
244+Do You Have "The Right Stuff"?
245+==============================
246+
247+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.
248+
249+* We should talk about some standard roles here. The "hunter", the "farmer", the "manager", etc.
250+
251+Although from the outset, setting up a team seems simple, getting a successful
252+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,
253+but also ability to inspire the team where to move forward,
254 be organised and resolve conflict where required. Setting up and leading
255 a LoCo team is not about forming a group and telling people what to do -
256 it is about forming a group and inspiring people to do amazing things.
257@@ -18,17 +24,26 @@
258 Getting Started
259 ===============
260
261-When deciding to create a LoCo team for your area, you should first decide
262-which particular region you want to create a team for. Before you continue,
263-first check to see if an existing team exists. See the `full list of LoCo Teams <http://loco.ubuntu.com/teams/>`_
264-and look to see if there is one in your area.
265-
266-Generally LoCo teams have a fairly large catchment area. So, as an example
267-the UK LoCo Team have a single group for the entire country. This is because
268-the UK is a fairly small country. However, as part of the UK Team, smaller
269-meetings around the country happen, but they all fall under the remit of
270-the UK LoCo team. For larger countries such as the USA, it is more common
271-to have LoCo teams at a state level - the country is too big to have one single LoCo team.
272+So, you think you have what it takes to make an Ubuntu team in your area? Great!
273+
274+When deciding to create a team near you, you should first decide
275+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.
276+
277+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.
278+
279+Before you continue,
280+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/>`_
281+
282+
283+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,
284+the United Kingdom (UK) LoCo Team have a single group for the entire country. This is because
285+the UK is a fairly (geographically) small country. However, as Ubuntu has grown,
286+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
287+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, )
288+
289+
290+
291+* RR: The below text is sounding bureaucratic and I recommend we consider spinning it out of the advocacy kit, or re-work it significantly.
292
293 Each LoCo team is intended to support all variants of Ubuntu/Kubuntu/Edubuntu
294 etc. If you want to set up a specific group for a derivative, you should do
295
296=== added file 'adk/tips.rst'
297--- adk/tips.rst 1970-01-01 00:00:00 +0000
298+++ adk/tips.rst 2012-12-19 22:10:25 +0000
299@@ -0,0 +1,48 @@
300+Tips For Ubuntu Advocates
301+-------------------------
302+
303+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:
304+
305+1. **Pronounce "Ubuntu" correctly.** It's pronounced “Oo-boon-too”. This
306+might sound like something trivial or pedantic, but please recognize
307+that when you mispronounce a word, your credibility may be called into question.
308+
309+2. **Use Ubuntu yourself. Every day.** Make it your sole operating system and
310+immerse yourself in it. After all, if you're not confident enough to do so, why should anyone else?
311+As Gandhi once said, “Be the change you want to see.”
312+
313+3. **Don't assume people have ever heard of it.** Pretend it's brand new to them.
314+Introduce Ubuntu as Ubuntu, and skip the references to arcane systems of days gone by,
315+and also skip the computer science minutia. Most people don't care and tend to tune out
316+if you try to impress with jargon or recount a technical history lesson.
317+
318+4. **Choose your targets.** Don't assume that everyone is ready for Ubuntu. Some aren't.
319+Since you have limited resources and time, try to gauge whether a person is receptive
320+to new ideas and ways of thinking, generally. Ask them some probing questions (without
321+saying Ubuntu) that will help you understand their comfort with change. If they seem to
322+be open-minded, give it a shot.
323+
324+5. **Don't be a soloist.** You're not the whole Ubuntu community. The millions of people in
325+the world who use Ubuntu collectively have a much greater wealth of Ubuntu knowledge than
326+yourself individually. So, if you've found someone that you think is ready for Ubuntu,
327+encourage them to participate in the community as their next step. There's no substitute
328+for a community and the person you guide way will be richer in knowledge because you have
329+done so.
330+
331+6. **Learn about Ubuntu and know it well.** If you don't know something, defer to the Ubuntu
332+community. Someone out there will know it. Don't make up answers.
333+
334+7. **Always be prepared** to give a brief but interesting demo. Have a good, clean working system
335+running the latest released version of Ubuntu. Ideally, you'll want a separate user on your system called “demo”
336+or something similar set up so you're not exposing personal files or strange configurations and settings
337+that will confuse your target audience. Encourage them to play with the system themselves.
338+
339+8. **Never compare Ubuntu** with other operating systems, free or not. When you do, you draw people's
340+attention away from your message and towards a competitor's. Don't name competitors' names. Refer to their
341+products only if asked specifically, and only in the general sense.
342+
343+9. **Use stories.** People appreciate a good story about your personal journey. How did you discover
344+Ubuntu? What impressed you the most about it? When did you make the decision to never turn back?
345+Even though these tips will likely steer you in a good direction in your advocacy efforts, never forget
346+that there are no universal strategies. Every person you approach will need a slightly different
347+flavour of the above.
348\ No newline at end of file

Subscribers

People subscribed via source and target branches