Skip to content

Commit 9171d01

Browse files
authored
Merge pull request #291 from michizhou/michizhou-patch-2
Fixed typos and errors in developer community documentation
2 parents 5fc66ad + ad3a3b8 commit 9171d01

File tree

3 files changed

+29
-29
lines changed

3 files changed

+29
-29
lines changed

developer-community/events.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55
Our tech talks are one-day conferences held in Madrid at our offices, or elsewhere, where we invite up to 7-8 speakers to talk to us about a very advanced topic related with Infrastructure, Machine Learning, Frontend & more (suggestions are always more than welcome)!
66
You can check all past events [here](http://talks.sourced.tech/) and all talks, as we record everything.
77

8-
When we organise such events, we expect the team which is closer to the topic of the event to closely help organising it. That means that for Frontend, for example, the entire platform team is responsible for choosing and inviting the speakers, approving their talks and hosting the event on its actual day (exceptions will exist of course, but this would be the ideal case).
8+
When we organize such events, we expect the team which is closer to the topic of the event to closely help in organizing it. That means that for Frontend, for example, the entire platform team is responsible for choosing and inviting the speakers, approving their talks and hosting the event on its actual day (exceptions will exist of course, but this would be the ideal case).
99

10-
The Community team will however support with all the speakers logistics, the venue, F&B, promotion materials, sponsors, communication and social media, etc.
10+
The Community team will however support all the speakers logistics, the venue, F&B, promotion materials, sponsors, communication and social media, etc.
1111

1212
These events usually count around 100 attendees.
1313

@@ -16,16 +16,16 @@ These events usually count around 100 attendees.
1616

1717
Thanks to Maximo, we host the [GoMAd](https://www.meetup.com/es-ES/go-mad/) meetup on a monthly basis here at the office!
1818

19-
On a less frequent basis, we host any meetup that asks us to - if you know anyone looking for a venue for a <75 people event feel free to suggest the back of our office. Besides, depending on the occasion, we'd be happy to sponsor drinks and pizzas/snakcs for them too!
19+
On a less frequent basis, we host any meetup that asks us to - if you know anyone looking for a venue for a <75 people event feel free to suggest the back of our office. Besides, depending on the occasion, we'd be happy to sponsor drinks and pizzas/snacks for them too!
2020

2121

2222
## Beer Payback's
2323

2424
As we try to aim for consistency, we are calling any conference side events 'beer payback'. It's not the best name, and suggestions, again, are welcome, but it's what we have at the moment.
2525

26-
Beer payback's are usually events that we organise abroad, next to conferences that the team is attending and which crowd would be great to engage closely with. We've done so at:
26+
Beer paybacks are usually events that we organize abroad, next to conferences that the team is attending and whose crowd would be great to engage closely with. We've done so at:
2727
- FOSDEM, Brussels
2828
- MSR, Buenos Aires
2929

3030

31-
### Besides the above three types of events we help organise, we're always on the lookout for CFP to submit and get anyone from the team speaking at third-parties events that could be interesting to reach and attend. This is strongly encouraged from anyone in the team and something that we cover expenses for (if said conference doesn't already).
31+
### Besides the above three types of events we help organize, we're always on the lookout for CFP to submit and get anyone from the team speaking at third-party events that could be interesting to reach out to and attend. This is strongly encouraged from anyone in the team and something that we cover expenses for (if said conference doesn't already).

developer-community/fix-DCO.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# DCO is missing
22

3-
If you are reading this, then you want to contribute to one of the source{d}'s projects.
3+
If you are reading this, then you want to contribute to one of source{d}'s projects.
44
That's awesome and we're glad you're here 👍.
55
However, this also means that you probably have not added the "signed-off-by" signature to one or more of your commits in the pull request.
66

@@ -10,10 +10,10 @@ You may now have a fair question: why does source{d} enforce the DCO? There are
1010

1111
1. By signing off the contribution, you are certifying it is either your intellectual property or a valid contribution given its respective open source license origin.
1212
2. It follows that your contribution is, by default if valid, considered your intellectual property in countries such the United States.
13-
So you could ask the project maintainer to remove one (or more) of your contributions in the future.
14-
This may get very complicated as the project grows larger and well-known: imagine rewriting the Git history for everybody!
13+
Thus you could ask the project maintainer to remove one (or more) of your contributions in the future.
14+
This may get very complicated as the project grows larger and becomes more well-known: imagine rewriting the Git history for everybody!
1515

16-
Thus, the DCO works as a sort of an insurance against such cases.
16+
Thus, the DCO works as a sort of insurance against such cases.
1717

1818
This manual should help you to add the required `Signed-off-by: Your Name <[email protected]>` to your commits in the pull request.
1919

@@ -76,7 +76,7 @@ git push -f origin <your branch here, probably "master">
7676

7777
### Fix Option #4: (Almost) Avoid Git
7878

79-
Git is sometimes frustrating, and you may want to keep distance from it sometimes, for safety.
79+
Git is sometimes frustrating, and you may want to keep distance from it sometimes for safety.
8080
For now:
8181

8282
1. Copy the modified files to a backup directory;
@@ -109,7 +109,7 @@ grep -qs "^${SIGNATURE}" "$1" || echo "\n${SIGNATURE}" >> "$1"
109109

110110
You need to do this for each repository independently.
111111

112-
If you want to create this hook **automatically** on every new git repositories you will create from now on (using `git init`, `git clone`...) you can use `git-templates`; to do so, just save the script described above into (duplicate files):
112+
If you want to create this hook **automatically** on every new git repository you will create from now on (using `git init`, `git clone`...) you can use `git-templates`; to do so, just save the script described above into (duplicate files):
113113
- `~/.git-templates/hooks/prepare-commit-msg`
114114
- `~/.git-templates/hooks/commit-msg`
115115

@@ -123,7 +123,7 @@ git config --global init.templatedir ~/.git-templates
123123

124124
### Sign-off Option #3: Git Aliases
125125

126-
Git aliases are like "shortcuts" to more extense commands and flags.
126+
Git aliases are like "shortcuts" to more extensive commands and flags.
127127

128128
You can add the following lines (or as you see suit) to your `~/.gitconfig` file:
129129

developer-community/tech-talks.md

+17-17
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,25 @@
22

33
Our tech talks host great speakers in an informal setting every ~3 months. Each series of talks will cover a different topic targeted to an experienced technical audience. Speakers will be invited both from Spain and abroad.
44

5-
Each edition is usually more related with one specific team and this is the group of people responsible for ensuring that the event meets the expectations of the targeted audience. This means that, for intance, the Frontend edition is co-organised by the Platform team. The teams are responsible for choosing and reaching out (only until first response) to the speakers but also helping them choose the topics they'll speak about and organise the schedule in a coherent way. They are also in charge of giving a long/lightning talk themselves and, if they want, present the whole event :)
5+
Each edition is usually more related to one specific team, which is the group of people responsible for ensuring that the event meets the expectations of the targeted audience. This means that, for instance, the Frontend edition is co-organized by the Platform team. The teams are responsible for choosing and reaching out (only until first response) to the speakers but also helping them choose the topics they'll speak about and organize the schedule in a coherent way. They are also in charge of giving a long/lightning talk themselves and, if they want, present the whole event :)
66

7-
Besides the team assigned to the specific edition, anyone who wants to volunteer and will have the time, close to the event especially, to do so, is, of course, more than welcome!
7+
Besides the team assigned to the specific edition, anyone who wants to volunteer and will have the time, especially close to the event, to do so, is, of course, more than welcome!
88

99

1010
# Speakers
1111
## Contact
1212

1313
Ideally, we should start contacting speakers __3 months__ prior to the event.
1414

15-
Our tech talks involve a total of __5 long talks__ and __2 lightning__. Someone from our team should always give either one Lightning or a Long talk. Hence, we should make an initial list of _6 people to contact_. If no reply, _follow-up after 3-5 days_ until you get an answer (up to 4 emails sent in total).
15+
Our tech talks involve a total of __5 long talks__ and __2 lightning__. Someone from our team should always give either one Lightning or a Long talk. Hence, we should make an initial list of _6 people to contact_. If there is no reply, _follow-up after 3-5 days_ until you get an answer (up to 4 emails sent in total).
1616

1717
Email copy:
1818

1919
> Hello Jane Doe,
2020
>
2121
> My name is John Eod, we met last year at techFest.
2222
>
23-
> I am working at source{d} and we are organising a one-day conference focused on infra/ML/front-end technologies. Please, feel free to take a look at our past edition, around infra/ML/front-end, on our website and check out the respective videos.
23+
> I am working at source{d} and we are organizing a one-day conference focused on infra/ML/front-end technologies. Please, feel free to take a look at our past edition, around infra/ML/front-end, on our website and check out the respective videos.
2424
>
2525
> We saw your talk ******** and this is exactly what we are looking for: an advanced technical talk that, while focusing on a particular framework, is useful for the community as a whole.
2626
>
@@ -38,13 +38,13 @@ Email copy:
3838
3939
When inviting speakers, please check how they present, speak (in English in our case), etc. You can usually find material online. If not, please schedule a short call, in English, with them so as to check all this before the actual invitation.
4040

41-
To avoid any last minute schedule changes due to potential cancellations, we should always ask someone from our team to have a long talk prepared. This way, if someone doesn't make it, there's an easy replacement available. If all else fails, please make sure to email all attendees as soon as you know this (please remember to organise **visa** - if applicable - for this person beforehand to make sure he/she can travel if needed).
41+
To avoid any last minute schedule changes due to potential cancellations, we should always ask someone from our team to have a long talk prepared. This way, if someone doesn't make it, there's an easy replacement available. If all else fails, please make sure to email all attendees as soon as you know this (please remember to organize a **visa** - if applicable - for this person beforehand to make sure he/she can travel if needed).
4242

4343
## Information & Logistics
4444

4545
From each speaker, we'll need to collect a __Bio, Picture, Title & Abstract__ in order to build the website.
4646

47-
If the speaker is not based where the talk takes place, we'll need to start organising his/her trip asap so that we avoid expensive last minute tickets & hotels.
47+
If the speaker is not based where the talk takes place, we'll need to start organizing his/her trip asap so that we avoid expensive last minute tickets & hotels.
4848

4949
Email copy:
5050

@@ -54,7 +54,7 @@ Email copy:
5454
>
5555
> As John mentioned, the event will be held on Saturday, MONTH DAY and all talks will cover quite advanced topics so hopefully it will be insightful for everyone, both attendees and speakers together.
5656
>
57-
> The event's schedule is not completely finalised but we will be sharing more details with you soon - general idea is to start with the first talk at 10am and finish them around 5.30pm. There will be breakfast, lunch and snacks throughout the day as well as a lot of beer and drinks to ensure a great day.
57+
> The event's schedule is not completely finalized but we will be sharing more details with you soon - general idea is to start with the first talk at 10am and finish them around 5.30pm. There will be breakfast, lunch and snacks throughout the day as well as a lot of beer and drinks to ensure a great day.
5858
>
5959
> Regarding the logistics, we will invite you over to Madrid/Moscow/World for the weekend and expect you at our offices on Saturday.
6060
>
@@ -123,7 +123,7 @@ Email copy:
123123
# Setup
124124
## Website
125125

126-
Please follow the README on our [Talks repo](https://github.com/src-d/talks) or ask [@serabe](https://github.com/serabe) for a little hand :)
126+
Please follow the README on our [Talks repo](https://github.com/src-d/talks) or ask [@serabe](https://github.com/serabe) for a little helping hand :)
127127

128128
To easily resize the HEADER pictures, use this handy set of commands:
129129
```
@@ -169,7 +169,7 @@ Details for the back office:
169169

170170
Our Meetup.com account details are secretly held by Máximo :)
171171

172-
Each new event, simply duplicate a previous one from our [tech talks group](https://www.meetup.com/es-ES/srcd-tech-talks/). Remember to set the registration as available till the following 5min so that by the time people access it, they can no longer register. This is important as to ensure that everyone gets a ticket on Eventbrite and there are no issues on the day of the event.
172+
For each new event, simply duplicate a previous one from our [tech talks group](https://www.meetup.com/es-ES/srcd-tech-talks/). Remember to set the registration as available till the following 5min so that by the time people access it, they can no longer register. This is important as to ensure that everyone gets a ticket on Eventbrite and there are no issues on the day of the event.
173173

174174
#### Twitter
175175
• Talks Announcement (after website is ready - speakers list might not be complete)
@@ -203,10 +203,10 @@ When the event is outside of Madrid, it's done on a case by case basis but we sh
203203

204204
## Printing Material
205205
#### Badges/Agenda
206-
Both Maximo & Esther have the details of the printing company. These need to be sent Thursday latest and they'll deliver them on the next day. Marcelo, or whoever joins as a Designer, will need to get all the specs at the beginning of the week but will know what to send to the printing.
206+
Both Maximo & Esther have the details of the printing company. These need to be sent Thursday at the latest and they'll deliver them on the next day. Marcelo, or whoever joins as a Designer, will need to get all the specs at the beginning of the week but will know what to send to the printing.
207207

208208
#### Stickers
209-
We order our stickers, and any other we print, from StickerMule. The more you order (both in terms of quantity of a single design and in terms of numbers of different design) the cheapest it is, of course. So ideally, let Esther know about this in advance so we can pack that order together with any other :)
209+
We order our stickers, and any other we print, from StickerMule. The more you order (both in terms of quantity of a single design and in terms of numbers of different design) the cheaper it is, of course. So ideally, let Esther know about this in advance so we can pack that order together with any other :)
210210

211211
Note that StickerMule takes around 2 weeks to ship these from the US.
212212

@@ -217,14 +217,14 @@ When the event is at the office, food works as follows:
217217
• Lunch: Pizzas (Allo Pizza) + Salads & other (DO EAT) + Ice Cream & Fruit (Tu Despensa)
218218
• Beers: Selection of Spanish cold meats & cheese (Esther's Secret)
219219

220-
When the event is outside of Madrid, it's on a case by case basis, ideally the venue takes care of it or helps organising it.
220+
When the event is outside of Madrid, it's on a case by case basis. Ideally the venue takes care of it or helps organizing it.
221221

222222
## Recordings
223223
When the event is at the office, we usually ask Origen Producciones to take care of it. They know how we want it and you just need to make sure they are free by emailing them (please ask Esther for the details). Until the end of the event you should also send them the pack-shots for each video cover. Example [here](https://drive.google.com/open?id=0B1AhN7PuQbtKdUFGejlaTkRzNlk) and [here](https://drive.google.com/file/d/0B9mze_Z8OL2fMl9rbDdhdGdIZFE/view).
224224

225-
When the event is outside of Madrid, it's on a case by case basis, ideally the venue takes care of it or helps organising it.
225+
When the event is outside of Madrid, it's on a case by case basis. Ideally the venue takes care of it or helps organizing it.
226226

227-
In both cases, they should be sending you the videos ready by Friday so that we have them all uploaded latest 10 days after the event.
227+
In both cases, they should be sending you the ready videos by Friday so that we have them all uploaded 10 days after the event at the latest.
228228

229229
## Speakers Dinner
230230
We usually invite all the speakers for dinner after the event wherever it is held (usually typical/traditional food from the hosting city/country). Past editions were as follows:
@@ -233,7 +233,7 @@ We usually invite all the speakers for dinner after the event wherever it is hel
233233
• Frontend: La Castela
234234

235235
## Cleaning
236-
Esther usually takes care of warning our cleaning person that they should come an extra day (on Friday) to clean everything. They already comes every Sunday so that one is taken care of.
236+
Esther usually takes care of warning our cleaning person that they should come an extra day (on Friday) to clean everything. They already come every Sunday so that one is taken care of.
237237

238238
## Welcome Talk & Event Hosting
239239
Our Welcome Talk and all speakers' introductions are done by someone from the team. This person should prepare their talk and include (at least): 1. Brief company description and a more in depth one of anything we're doing that is related with the topic of the talks; 2. Why we do these talks; 3. Schedule for the day, food and drinks, bathrooms (anything useful to know).
@@ -244,12 +244,12 @@ Always stick to it. No matter what. Don't start late nor early.
244244

245245
# Post-event
246246
## Survey
247-
We use Typeform for all things survey and, again, Esther has the secret logins if you need them. Simply duplicate a previous ones, edit names of talks & speakers and anything else you judge necessary and send it no later than Monday at lunch. You should send it to the actual attendees (based on anyone checked in from Eventbrite) and bcc them all in one plain-text Gmail thread (no need for cool designs here). You will later use this thread to tell everyone that videos have been published and can be found at link x.
247+
We use Typeform for all things survey and, again, Esther has the secret logins if you need them. Simply duplicate a previous one, edit names of talks & speakers and anything else you judge necessary and send it no later than Monday at lunch. You should send it to the actual attendees (based on anyone checked in from Eventbrite) and bcc them all in one plain-text Gmail thread (no need for cool designs here). You will later use this thread to tell everyone that videos have been published and can be found at link x.
248248

249249
## Metrics
250250
We keep everything tech talks related in our [Dashboard Excel](https://docs.google.com/a/sourced.tech/spreadsheets/d/1RwXVCFkzHvrLD15GPP9HFGzSPVQ4NbwZo7BNLqaDHoA/edit?usp=sharing).
251251

252-
Everything you do/try/test/dream about, you should track. If you're not feeling too creative, make sure to at least track everything that allows you to reproduce the Sheets 'Summary' which include: Attendees, Budget (everything), Twitter, Survey, Blog Post.
252+
Everything you do/try/test/dream about, you should track. If you're not feeling too creative, make sure to at least track everything that allows you to reproduce the Sheets 'Summary' which includes: Attendees, Budget (everything), Twitter, Survey, Blog Post.
253253

254254
## Videos
255255
Videos should be online and ready no longer than 10 days after the event. We/Máximo publish/es them on Youtube. Descriptions should include the slides of the presentations given that you already had asked the speakers for. Attendees should be notified but also anyone who didn't attend or was on the waiting list.

0 commit comments

Comments
 (0)