├── .gitignore ├── README.md ├── backgroundreading.asciidoc ├── evangelistmanifesto.asciidoc ├── evangelistmanifesto.html └── religiousHolyDays.asciidoc /.gitignore: -------------------------------------------------------------------------------- 1 | *.*~ 2 | *.~ 3 | *.~# 4 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Stuff to know 2 | 3 | 1. This is a collaborative effort so please share the praise but also pitch in 4 | 5 | 2. All this content is licensed: 6 | 7 | Creative Commons Attribution 4.0 International (CC BY 4.0) 8 | 9 | 10 | http://creativecommons.org/licenses/by/4.0/ 11 | 12 | Creative Commons License
This work is licensed under a Creative Commons Attribution 4.0 International License. 13 | -------------------------------------------------------------------------------- /backgroundreading.asciidoc: -------------------------------------------------------------------------------- 1 | = Good Resources for Evangelists 2 | 3 | == Specific about Dev. Evangelism/Advocacy 4 | 5 | https://github.com/codepo8[Christian Heilmann]'s http://developer-evangelism.com/index.php[book] 6 | 7 | http://compositecode.com/about/[Adron Hall]'s http://compositecode.com/2014/01/21/9-ways-to-survive-the-shit-storm-of-developer-evangelism/[blog post] 8 | 9 | The NextWeb http://thenextweb.com/dd/2012/06/03/a-day-in-the-life-of-a-developer-evangelist/[interviews some evangelists] 10 | 11 | http://caseysoftware.com/blog/author/keith-casey[Keith Casey], a former Twillio Evangelist, writes a http://caseysoftware.com/blog/developer-evangelism-the-whole-story[blog post] with his take on the field 12 | 13 | == Other Good Material to Sharpen your Craft 14 | 15 | http://shop.oreilly.com/product/9780596802004.do[Confessions of a Public Speaker] 16 | 17 | https://www.youtube.com/watch?v=OKY6BGcx37k[Talking Funny] - a video with Chris Rock, Louis CK, Ricky Gervais, and Jerry Seinfeld talking about their different approaches to doing comedy and how they approach their craft. 18 | -------------------------------------------------------------------------------- /evangelistmanifesto.asciidoc: -------------------------------------------------------------------------------- 1 | = Developer Evangelists Manifesto 2 | 3 | Good Developer Evangelists (or Developer Advocates) are bridges – they can talk and share information 4 | between multiple groups about a multitude of technologies. Internally they are a 5 | bridge between support, product management, engineering, and 6 | marketing teams. They are also a bridge between external developers and 7 | internal management and engineering. We are connectors in the broad 8 | sense of that word. 9 | 10 | ==== Other terms 11 | 12 | The role definition for Developer Evangelist can be a complex one, and overlaps 13 | significantly with other similar roles, which may have titles such as: 14 | 15 | * Developer Advocate 16 | * Platform Evangelist 17 | * Technical Evangelist 18 | * Developer Relations 19 | * API Evangelist 20 | * Developer Experience Engineer 21 | 22 | The important part that ties all these together is the type of skills needed 23 | and the focus of the job responsibilities. 24 | 25 | == Major attributes that make a good evangelist 26 | 27 | In order to be effective in their role they have to have some key 28 | attributes and engage in a broad array of activities. It is important to 29 | remember that no one evangelist will be excellent at all these skills 30 | or activities but they need to be competent in all the areas and still 31 | engage in all the activities. 32 | 33 | * Technical skills in working with code and technology. Without this they can 34 | not talk credibly to external developers nor can they communicate 35 | effectively with internal engineering. They must be able to write more code 36 | than a "Hello World" application. 37 | 38 | * Ability to speak effectively in public – they have to be able to get on 39 | stage, in front of a class, in front of customers, in a booth and convey 40 | both the marketing and technical message of the product. They have to 41 | be able to do it in a way that gets the developers excited about using 42 | the product and clearly see the benefits. 43 | 44 | * They need to be able to write effectively – they will need to write 45 | blog posts, respond to questions in forums, talk to users in IRC, write 46 | email to the engineering team, and send reports to management. 47 | 48 | * They have to be generally curious about technology and enjoy teaching 49 | it to others – they have to have a desire to seek out new tech and learn 50 | it, but they also have to generally have a desire to teach it to others 51 | rather than just use it for themselves. They need to be given time 52 | to read blogs, twitter, talk to developers at shows, and other media 53 | channels to keep up with trends in their field. They need to spend a 54 | certain amount of time reading and contributing to social forums. 55 | 56 | == What do Evangelists do 57 | 58 | In order to be effective in their role an evangelist has to engage in a 59 | broad array of activities. Some may be specialists in one of these areas 60 | but that does not mean they don’t have to be at least competent in all 61 | of these areas. Note this list is not in priority order since all of 62 | these activities are essential to be a good developer evangelist: 63 | 64 | * They need to get in front of developers – speaking at shows, attending 65 | shows, working at hackathons, talking or teaching at meetups 66 | 67 | * They need to be involved in some of the product management feedback, 68 | especially regarding roadmap issues so they can effectively communicate 69 | the product intention and direction to external developers 70 | 71 | * They need to be key stakeholders in the specification and development of 72 | developer-targeted features; as the main point of contact with developer 73 | users outside the organisation, their feedback should enhance the feature 74 | in order to meet those external developer's requirements 75 | 76 | * They need to be able to spend time talking to product engineers so they 77 | can effectively understand how the technology is supposed to work and 78 | give feedback so the engineers can understand how developers will use 79 | their product. 80 | 81 | * They need to spend time learning and using new technology, both in sample 82 | applications and real applications – this is the only way for them to be able 83 | to speak with authority both at shows and in written form 84 | 85 | * They need to spend some time teaching external developers how to use 86 | the products. They should also take the feedback learned in those 87 | classes back to the engineering team 88 | 89 | * They need to write blog content to help communicate their knowledge and 90 | interesting features for the platform. 91 | 92 | 93 | == Broad goals for Evangelists 94 | 95 | * Brand awareness – we help drive awareness for our product(s) and establish our 96 | company as a leader in Technology 97 | 98 | * Thought leaders in our own space - we each have an area of 99 | specialization and help to promote our product as a place where thought 100 | leaders work and that our opinion on a broad range of matters should be 101 | trusted 102 | 103 | * Making developers successful on our product - we work with the product team 104 | and external developers to help give external developers a sense of delight and 105 | excitement in using our product. 106 | 107 | == How are Evangelists perceived in the community 108 | 109 | Just as a sales person gains trust from their customers by delivering the 110 | software to them on time and with the capabilities they promised – 111 | developer evangelists have to be trusted by the community they are 112 | talking to. Their trust is based on technical knowledge, honest 113 | assessment of the capabilities of their software, and being able to 114 | relate to the workflow and ways in which developers think 115 | 116 | -------------------------------------------------------------------------------- /evangelistmanifesto.html: -------------------------------------------------------------------------------- 1 | EvangelistManifesto

                  2 | 3 |                  

Developer Evangelists Manifesto

Good 4 | Developer Evangelists are bridges – they can talk and share information 5 | between multiple groups about a multitude of technologies. Internally 6 | they are a bridge between support, product management, engineering, and 7 | marketing teams. They are also a bridge between external developers and 8 | internal management and engineering. We are connectors in the broad 9 | sense of that word.

Broad goals for our team

1) Brand awareness – we help drive awareness for our product(s) and establish our company as a leader in Technology

2) 10 | Thought leaders in our own space - we each have an area of 11 | specialization and help to promote our product as a place where thought 12 | leaders work and that our opinion on a broad range of matters should be 13 | trusted

3) Making developers successful on 14 | our product - we work with the product team and external developers to 15 | help give external developers a sense of delight and excitement in using 16 | our product.

How are Evangelists perceived in the community

Just 17 | as a sales person gains trust from their customers by delivering the 18 | software to them on time and with the capabilities they promised – 19 | developer evangelists have to be trusted by the community they are 20 | talking to. Their trust is based on technical knowledge, honest 21 | assessment of the capabilities of their software, and being able to 22 | relate to the workflow and ways in which developers think.

Major attributes that make a good evangelist

In 23 | order to be effective in their role they have to have some key 24 | attributes and engage in a broad array of activities. It is important to 25 | remember that no one evangelist will be excellent at all these skills 26 | or activities but they need to be competent in all the areas and still 27 | engage in all the activities.

1) 28 | Technical skills in working with code and technology. Without this they 29 | can not talk credibly to external developers nor can they communicate 30 | effectively with internal engineering

2) 31 | Ability to speak effectively in public – they have to be able to get on 32 | stage, in front of a class, in front of customers, in a booth and convey 33 | both the marketing and technical message of the product. They have to 34 | be able to do it in a way that gets the developers excited about using 35 | the product and clearly see the benefits.

3) 36 | They need to be able to write effectively – they will need to write 37 | blog posts, respond to questions in forums, talk to users in IRC, write 38 | email to the engineering team, and send reports to management.

4) 39 | They have to be generally curious about technology and enjoy teaching 40 | it to others – they have to have a desire to seek out new tech and learn 41 | it, but they also have to generally have a desire to teach it to others 42 | rather than just use it themselves all the time. They need to be able 43 | to read blogs, twitter, talk to developers at shows, and other media 44 | channels to keep up with trends in their field. They need to spend a 45 | certain amount of time reading and contributing to social forums.

What do Evangelists do

In 46 | order to be effective in their role an evangelist has to engage in a 47 | broad array of activities. Some may be specialists in one of these areas 48 | but that does not mean they don’t have to be at least competent in all 49 | of these areas. Note this list is not in priority order since all of 50 | these activities are essential to be a good developer evangelist:

1) 51 | They need to get in front of developers – speaking at shows, attending 52 | shows, working at hackathons, talking or teaching at meetups

2) 53 | They need to be involved in some of the product management feedback, 54 | especially regarding roadmap issues so they can effectively communicate 55 | the product intention and direction to external developers

3) 56 | They need to be able to spend time talking to product engineers so they 57 | can effectively understand how the technology is supposed to work and 58 | give feedback so the engineers can understand how developers will use 59 | their product.

4) They need to spend time 60 | learning and using new technology, both in sample applications and real 61 | applications – this is the only way for them to be able to speak with 62 | authority both at shows and in written form

5) 63 | They need to spend some time teaching external developers how to use 64 | the products. They should also take the feedback learned in those 65 | classes back to the engineering team

6) They need to write blog content to help communicate their knowledge and interesting features for the platform.

-------------------------------------------------------------------------------- /religiousHolyDays.asciidoc: -------------------------------------------------------------------------------- 1 | = Major religious holidays to avoid for your events: 2 | 3 | Here are the major religious holidays you need to be aware of when planning events. The list covers holy days where 4 | 5 | * Work is prohibited (or most people observing consider it a day to be with family) 6 | 7 | AND 8 | 9 | * Followed by most of it's adherents 10 | 11 | "Most" is a tricky term and is definitely geography dependent. If you live in a Christian majority country - the holy days below 12 | are like Christmas or Easter. Before you schedule an event during these days think if you would schedule the same event during 13 | Christmas or Easter. 14 | 15 | == NOTE on Google Calendar 16 | If you happen to use Google calendar for scheduling, they have an option to add calendars for Christian, Jewish, Muslim, and Eastern Orthodox holidays. They also have holidays for different countries. It's pretty simple to do and can save you a lot of trouble. The list below should help you identify which holidays are most important to pay attention to in the calendar. 17 | 18 | If you edit a category below please: 19 | 20 | 1. Try define most, especially with regards to important geographies. 21 | 2. Please try to give the rough time of year so people can know when to look for the holy day on the calendar. 22 | 3. Try to give the length of the holy day (start time and end time). 23 | 4. If you know there is popular misconception of the importance certain days please note those days as well. 24 | 25 | 26 | == Christianity 27 | 28 | [options="header"] 29 | |====================== 30 | |Name(s) |Season | Length |Start and End Time | Notes 31 | |Christmas |Dec 24th-26th |3 days | | Some countries (esp. USA) consider the 24th (Christmas Eve) important, others (UK, Ireland) consider the 26th more important. 32 | |Easter |Spring| 2 days| | Most Catholic countries have Easter Monday off as a holiday, some also have Good Friday. 33 | |====================== 34 | 35 | == Islam 36 | 37 | [options="header"] 38 | |====================== 39 | |Name(s) |Season | Length |Start and End Time | Notes 40 | |Eid al-Fitr|Summer| 1 days| | Fluctuates based on when Ramadan ends 41 | |====================== 42 | 43 | == Buddhisim 44 | 45 | == Hinduism 46 | 47 | Hinduism has a number of important festivals, and the significance of these varies by the region the person came from. Hinduism follows a lunar calendar. There are very few days when work is prohibited, but quite a few when people will choose to be with family. Some of these days are important regional holidays in India, but limited to cultural celebrations outside that region. 48 | 49 | [options="header"] 50 | |====================== 51 | |Name(s) |Season | Length |Start and End Time | Notes 52 | | Makar Sankranti/Pongal/Lohri | Usually January 14 | 1 day - 4 days | | This is more important for people from the Southern part of India than the north. 53 | | Holi | Spring | 1-5 days | | This is the well known 'festival of colours'. This is a day when most people will stay at home in India. 54 | | Gudi Padva/Ugadi | 1 day | Spring, late March/early April | | This is the new years day for Maharashtrians, Sindhis, Kannadigas and Telugu people. 55 | | Vishu | 1 day | Spring, usually mid April | | New year in Kerala. 56 | | Rath Yatra | 1-10 days | June/July | | Important in eastern and north eastern India. 57 | | Ganesh Chaturthi | 10 days | late August/early September | | Important in Maharashtra 58 | | Dusshera | 10 days | October | | This is one of the two major festivals which are celebrated pan India. Various individual days are important in different communities, and in certain regions work is disallowed on the 9th day. 59 | | Diwali/Deepavali | 5 days | October/November || This is one of the two major pan Indian festivals. 60 | |====================== 61 | 62 | == Judaism 63 | 64 | [options="header"] 65 | |====================== 66 | |Name(s) |Season | Length |Start and End Time | Notes 67 | |Passover (Pesach) |Spring |8 days |Sundown the night before until Sundown of the 8th day (only the first two days and last two days work is prohibited) | a lot of dietary restrictions 68 | |Rosh Hashanah |Autumn| 2 days| Sundown the night before until Sundown of the 2nd day| This is the New Year and the beginning of the Week of Awe, ending with Yom Kippur 69 | |Yom Kippur |Autumn| 1 day| Sundown the night before until Sundown the night after| This is a day of fasting and it usually concludes with a festive meal, so most people won't travel until the next day 70 | |Sukkot/Simchat Torah |Autumn| 9 day| Sundown the night before until Sundown the night after (only the first two days (Sukkot) and last two days (Simchat Torah) work is prohibited)| 71 | |====================== 72 | 73 | * It is not forbidden to work on Hanukah and it lasts for 8 days, though it's a time when many families get together. If you want to schedule something during 74 | this time it would be best to just avoid having people miss the first night. 75 | 76 | If you are planning an event in Israel this list will not work. There are many observant Jews in Israel and you should 77 | consult a local observant Jew about dates. Please note there is also a sizable number of Christians and Muslims in Israel, 78 | be sure to consult their calendar as well. 79 | 80 | = Major public holidays to avoid for your events: 81 | 82 | Some countries attach a particular importance to certain holidays, which tend to be 3 or 4 day family holidays. If you expect a significant contingent from these countries, you should beware of scheduling the event on the week these holidays take place, or at least allow people to get home the night before the holiday. 83 | 84 | == International 85 | 86 | [options="header"] 87 | |====================== 88 | |Name(s) |Season | Length |Start and End Time | Notes 89 | |May Day |Spring |1 day |May 1st | Internationally recognised as a holiday for the labour movement. For many countries, this day is an important day off. 90 | |====================== 91 | 92 | == USA 93 | 94 | [options="header"] 95 | |====================== 96 | |Name(s) |Season | Length |Start and End Time | Notes 97 | |Thanksgiving |Winter |4 days |3rd Thursday in November through Sunday | Big family get-together 98 | |Memorial Day |May| 1 day| Last Monday in May| Americans typically celebrate the start of Summer with family on this 3 day weekend 99 | |Independence Day|July 4th | 1 day | | Fireworks and barbecue 100 | |Labor Day|September| First Monday in September| Americans celebrate the end of summer with a 3 day weekend 101 | |====================== 102 | 103 | == Ireland 104 | 105 | [options="header"] 106 | |====================== 107 | |Name(s) |Season | Length |Start and End Time | Notes 108 | |St. Patrick's Day |March 17th |1 days | | 109 | |====================== 110 | 111 | == The Netherlands 112 | 113 | [options="header"] 114 | |====================== 115 | |Name(s) |Season | Length |Start and End Time | Notes 116 | |King's Day |April 27th |1 days | | 117 | |Remembrance of the Dead |May 4th |1 days | | 118 | |Liberation Day |May 5th |1 days | | 119 | |====================== 120 | 121 | == Brazil 122 | 123 | [options="header"] 124 | |====================== 125 | |Name(s) |Season | Length |Start and End Time | Notes 126 | |Independence Day |Summer |1 day |September 7th | 127 | |====================== 128 | 129 | == Canada 130 | 131 | [options="header"] 132 | |====================== 133 | |Name(s) |Season | Length |Start and End Time | Notes 134 | |Victoria Day/ National Patriots Day|Spring|1 day |3rd Monday in May|1 week before Memorial Day in the US 135 | |Quebec National Holiday|Summer|1 day |June 24 |Province of Quebec only. French: Fête nationale, a.k.a. St-Jean Baptiste. Unofficial start of the summer season activities in Quebec. Many combine this with Canada day to take an entire week off 136 | |Canada Day|Summer|1 day |July 1 |A major Canadian holiday celebrated across the country with fireworks, outdoor music events, street fairs, etc. 137 | |BC Day/ Heritage Day|Summer|1 day |First Monday in August|Provinces of British Columbia and Alberta only 138 | |Thanksgiving Day|Fall|1 day |2nd Monday in October|Thanksgiving is a statutory holiday in most of Canada. All federal government, crown corporation offices and banks are closed. Coincides with Columbus Day in the US 139 | |====================== 140 | --------------------------------------------------------------------------------