just a bit about myself first so you know what i'm talking about this i

first became involved as them contributor

if you years ago when they put the speakers and outreach program and i have

some state on and it's i have a meant to the number of vendors i

have mended to attic outreach program of the one now and if you outside the

program as well

i've become quite involved in the comedian should think

and now i will depart will work with people who are actually starting actually to

the community for the first time

and well you what might have very different expectations

and some people come as the user like as i have so i have been

a user for sex seven to half years now but then each arts are contributing

a few years ago

and some people come to work for example if they are doing an internship with

a company and

and they're not companies and opened them they might want for their interns to work

with the community to fix some bugs

that happens quite often

so gently percent someone comes along which is exactly what type of this well as

almost everyone does that is they just went about to fix

a somehow fix that usually some really bad patch

and they further with the wall but still it and for get about that well

maybe not forget about that in quite that way sometimes they will

say come back to the few among like to save why hasn't this been committed

or if you sometimes the developer mentally or one of the other developers will review

it and commit that some still just outright rejected that in your reasons

and sometimes they'll just fix it up themselves and tell us so possibly back to

the person who actually wrote that's

and so it varies quite a lot but so that's but actually get he'd become

for the community and it just doesn't work with getting people

people see that happen and they just me because

they didn't get anything


the way to actually become point meetings to talk to the can if you can

talk to the person who's doing work for you that you didn't get to know

you don't understand why maybe the drinks things a certain way which are not happy

with as well and as the contributing you might not understand what the developer is

trying to get you do something like you don't think is right

so you really need to talk to people and also i think starting are usually

just mousey it was really friendly there's no harm in just asking questions and generally

people get really positive responses

there are like we actually have i name lot of fruit which is

which consists of difference a lot across all the aspects we have people who are

willing to mentoring all once more tasks for all

would like you can go and ask that you can just look at the list

of people and you can go up to them and ask and almost at all

the will just say sure all hope you all that you

so it's definitely what talking and actually the best thing you can do is talk

to people at conferences

even if you're not really for the community at it's so what's going because you

can actually meet everyone and you just become really involved when you realise ones also

so ask for help

use the resources that are available

and just try to get in there and some get people to help you and

but you need to actually ask what the hell

and sometimes people might be a little bit want one event like you and something

like you very much

we have had the location box somewhere

someone's well the wide explains why they thought that was about and that's always come

along and said that it's possible and after that

i don't happens and that's okay

people have lives outside

so not everyone actually has time to go through every single but that like gets

filed against the project and you really liked about you explain how the point have

works in detail because actually that is very time-consuming i can relate to that because

i have on occasion had so

some people like file loads of bugs in one go and attach say twenty patches

each of which that takes a whole data review and let's be honest i don't

have twenty days to review twenty patches because i've got work to do i've got

other projects to contribute that i'm working on a of like outside the minutes

and that's just one right expects

okay innocent for viewers to actually be able to deal with that

and i know it's have we does happen to other people in the spring

so please don't do that to maintain is these them do that to a review

it's just not very fair on them and you will actually get really bad results

as a contributor

so try to like it's the first batch is always the most difficult one out

of all the patches so contributors need to try be considered was the review where

is try to make it easier for the patch to be reviewed which usually means

it's actually easiest to

to if we are first batch to be a really small sites

just a short patch to fix


rather than a very big one which anson if each or something like that

and us be patient but you contribute is like we don't always know that someone

is who has just well the patch is the it's really difficult to tell


to be honest there is no way of knowing allegedly actually talked about

so we should always talk to the contributors and always find out why there are

these huge patches all of a sudden when we never heard

and the sometimes it's actually rather the going back and forth and reading something say

for and having twenty reviews catalogue still which is a real pain

just sometimes maybe austin trying what something smaller

and get back to that once there but for experience

of course

then you can choose can always make it easier for us to review and we

really appreciate that

and the best way to do that is to actually find out how the project

works because different projects but for different what

i want to completion team and generally would prefer for new contributors go through bookseller

because than anyone that you review the work

and we have quite high standards for what we want to and is

we spent a lot of time getting our project up to really good quality and

we would like that so we don't we don't accept at every single patch that

comes along something as we go back and forth with review what before we're happy


and we are trying to get the person who's contributing to actually perfected themselves rather

than touching up attachments all you have for think minor things like indentation what senator

some other projects

but a is will just take a patch and they will fix some things like

that so

and that based on project what

for example well like and then we most of us prefer for patches to get

about so sometimes like very small patches are some artsy just expand very is very


or by email directly to them and they know or reviewer

but generally to about so on the other hand there other projects which have quite

a different one for example for the current know all the patches good for me


and that can be quite scary to present you do that

because generally it's a completely different way of sending patches and it

but if the contributors knows what we expect of that and that we know what

they expect of us than this whole process is easier

of course it does actually help what and this is where many contributors

fail slightly and that they didn't test their patches they didn't build

and they didn't test whether everything

so i was actually quite cumbersome to explain so why for example the change gold

installation is not working

for i see it's very difficult and so i recently i was recently working with

a girl who

was trying to use change build one last time and took her two weeks to

get to working state for a very simple application which for me builds out of

the box

i just

it took me five that's get built a form at the two weeks i don't

actually very difficult to debug that's but it's really what they have to because now

that she has a running she's actually able to document the latest version of the

application what's in boston which means she's not we still have

by fixing things which are really fixed

and of course what also happens what open is that

like will submit a patch and the whole set of the solar it for more

maybe for to just because i think that might be busy there someone else to

you about also happens

it's really worth being page

it really is but on the other

that you need for up as a contributor if you don't

then your patch much of sport and that will become obsolete that's not really

what that to be honest

it's a waste of your time as a contributor it's a waste of them they

have time

as maintainer because paul we don't meet someone else of concept of ready fixed we


so far the with your and for work with a review

but be patient since my kids people because people really didn't like that and they

want treaty as well if you do that

and of course it as i was saying it always helps to make good contribution

so make sure your contributions of a high quality the best you can do you

and maybe you should so consider talking to the community before you actually start making

before you start writing it because

sometimes the development data have very specific ideas about how they want to certain about

six i'm not might not be compatible with yours and sometimes they're the different ways

to fix the same power

so do to go back and actually talk to people

do discuss how you're going to fix things

and if you're reviewing patch assessment think that or if you're

tell them what you expect

don't accept that you shouldn't always accepts

i've fixed which are not what we have to it's not it is actually what

going back and asking people to fix stuff that way because then they realise that

what they're doing your thing and the like

and that's all have

so also make so you know you know what the work for your project is

busy much for each other that well into business with what

this they have talked to them and they you know whatever fever

stick to

tried to comply because that will make the reviewer's job easier and the that means

they will have more time to if you know patches or they will have more

likely some losses patches either way what you but

and once you start contributing you've contributed if you times you are get to know

what the project is like you know work with that

and you something

most of the people from the community

and if you actually don't really have all the project you should become foundation that's

how it works

as a punishment thank you get small parts it's very good and you get a

bit for the board as well

so this is actually more like what you expect

you don't want you to be a you'll find your problem and starts firing up

i try to michael sometimes you will if a simple boxing might but actually but

average want you might find that your about an application you think that's it

it might be something else

and you need to find that and you need to fix beverage that's the right

way to do things

it's actually in the long run better for the whole projects

if you don't take shortcuts do things for me if you know who to talk

to and you actually that are out who to talked about certain parts of the


it comes with experience

but that is actually you want you should

okay with me to of got simply who is white under from the previous outreach


she has actually had experiences with which is what we surely so tribute lots here

which is good for you have you found

i i'm single

i'm very send job change program from an intern in thought now i'm doing we

will some record internship but no

still a i mean you tell you my experience is we how we started country

rooting through the documentation team

first are still free eight years i'd use you know for each years now in

to i the only question in the back my head with how do i start

okay start you know with the starting point with the start button

and they'll

true do you might experience i learned that you just start with your favourite application

or me whichever application using your favourites

so look for buttons look for problems in your favourite application

in start small

i didn't i couldn't do anything big the first batch i mean what a one

line change and non dictionary documentation it was just one line you know he was

way small but what i did that i could i could start making other step

and tell i have to learn a couple of new tools like mallard

for writing this hell

and i did not know how to order hungry start using all the stuff i

don't remember but i don't know

and i sort okay so i'm gonna open up an editor and i'm gonna use

mallard to make a page about myself i like so and so

and there in about ten to fifteen minutes that evening i lunch mallard

i wrote everything about myself in that page and so i use that to make

a fun project for that evening

nine next step what do we this light words

in be sign words are we keep ages

you google upstart you go to non week and you meet real people in these

real people who are on i receive mailing this chat

so or we could just are nothing but sign words they tell you to talk

to our what you can expect from the project what tell tasks that ought to

be completed in the project

these are the sign words you must read and there in plain english so anybody

can understand it

then i have a question how can i help how can i do my part

when i did not know what i can do or how we can start i

did that one question everyone how can i help there is nothing in a list

of the gonna love that it's me so i asked the person i'm talking to

do you know anything i can do

and you would give me a related stuff so i'd like to onto that in

do more things

this is my favourite a lot one of your mentors

so i think about in so it's in the procedure of being sold someone's asking

to do something on the page and i want to watch it i want to

know how they're going to fix that wanna watch them fix it so i see

myself there is a there is a call them would like to add your email

the but it and i a lot how people are doing things i don't participate

i just well i watch the conversation up till the end in so i learn

new things from looking at a lot of it long working and what is a

what is appreciated what is not appreciated i learn by observation

so once i start walking i mean it starts printing a little faster

the first step and sprinting is just start talking to participate to say but hey

i'm interested and that's you know to raise up your hand

and when i mean participates

i look at the but page in if there is anything not all is not

something i don't understand i mean try to commence but before it was that it

meant i'm going to read it and see if i asked what i want to

know what i what answer what answer to the question i want to receive feel

i make sure my questions are simple

there specifically about something i meet my commands before i posted

and i get the conversation going

the next step that i did when i start contributing with do is cancer documentation

i'm i have terrible lack of focus and so

i got the resources the resources for a project ready sell your looking at documentation

out there is

our a know develop a lot of our project style guide open projects that i

feel it's all our data but it's what they read in the menu scheme to

read you become familiar with

many parks that you want to describe in your documentation

in that there is another kind in line documentation when i started no i'm somewhat

of course

you know

okay so it was like order start from problem know what to use in there

is in line core blocks documentation so these are information about what functions you can

use and there within and like pretty so i started reading that a with this

i can do this so that's good but don't know

when i did not know what's going on or i face didn't have a or

a syntax that or any kind of at a i just simply copy paste the

thing in google and look it up and look it up in many different ways

many different such very nice

because i the one can help myself best because i know the problem in sell

it's high likely that there are other people like me facing the same problem looking

for a solution so

all people as you that they're unique case no that's not true you problem you're

facing it's not it's very likely that someone else had the same problem and he's

posted on mailing lists right

so if you have a much that you could to go you can fix it


and then another thing i for with turned the page backwards

i follow examples how do it by observing stuff

so i have originally use a manual for non dictionary in someone's later i came

to know of that it wasn't released so would be what i did with not

available for packaging for users to see the use of manual is not there

in a i i'm gonna do it myself how

so i went to the we keep pages i went through previous really them it's

and i just

although the same step by step thing and i ended up doing big non fiction

and we used by myself in the help of my

man you know


keep your keep your options open look at examples

and don't is better than perfect so when i first run and around the of

the relief we do with of my mentor already manual sell he you know you

could fix that there was suggestions back and forth and it was nice it's better

than perfect just put it out there so they're gonna tell you what's wrong and

you can work on it you can you can see previous example you can learn

from it

okay now that we did good sprinter let's start running in the though and how

do you do it fast you might read faster

specifies the

and i when i submitted patches on a on but pages i'm each other my

email was right next to me i was glancing at it because they are it's

likely your review will give you an instant review or you'll have to bring someone

with whatever it is people watcher we email in you will be subscribe to the

what we also you can communicate when that person is we see are you gotta

you don't you should weights on the person was gonna give your review

and so

if you're gonna be fast you gonna get ahead in i submit things that standard

patches and you catching up on the reviews you know don't let other people weeks

for you writing as soon as you see it do it

and learn from your function

well when i was in the audience for government internship my mentor how to repeatedly

fee and i decided that you know a very limited amount of memory what i'm

gonna do doesn't make check with i'm gonna make czech bliss

so i can run my work against it every time i submitted and this is

a good check so he started we you know step by step i am you

level in the product of have so when i don't check list your use different

sections my what what's out review because i can help myself best

in that i can learn from examples i can learn from previous advice

i just need to make a check with

in i i'd like to say the support the greatest like tell us tell you

and remember that

it is for other member and it's go on what are what are we couldn't

do you know it was three there or so i write everything down unnecessary everything

that i would have done so because it is useful for other somebody else like

you is looking for help any you write down if you pick something if your

family something it helps it helps that some other person is going through the same

thing as you so you are documenting your learning process in so you should make

we keep pages check this out

but i was somewhat you learn what you fix what you're not able to learn

your problems it's good to write things down

now we have a started running are doing good for doing good in we cannot

on long distance and they say this is something i've been falling for a while


i'm be snoopy person so i still one people on but don't know in a

there is a but law a

people use but the love for submitting patches

one of them is you folder you mentors you can watch your mentors activities so

you know what of what your views the giving you can learn from their comments

and so you can see the new but i think i hope you can you

can watch projects so you can see new bucks or you can also make bookmarks

that you can check for particular keywords so you're interested in fixing easy no buttons

what market you can check out you can search but if you can book market

you can check it once in a while

that's about the like tricks like that and i i've written a lot was about

how you can start of you know keeping on top of but will activity can

see that at the end like the end


you must allow people to have okay so you use to be open you have

you of you have some questions and we a little

get you authors you so if i think something for me she saw something for

me at anybody saw something for me i would ask them what to do that

i wanna know that

you know you a because you should learn from how they've done it

still you can teach someone else you can learn yourself in the learning process that

going on

next one is not

an alignment still be documentation according you need we can test what you've written what

you've done

in the just like get a little tricky because there a couple options and what

might well a somehow what everyone else

so i've been told to install it it's built for some time

why render of every know i hide open and if they used the edge build

sell it gentleness get but it didn't work for me so i have an alternate

method how i do things like compile build that

so whatever what's the you look it up and stick to it

makes you do new things

i start the documentation in i was interested according fixing about

and how to fix bugs you know the easiest bugs the string bugs so is

ellipses are a bit all have

have to letters not there and that you know string buttons thank you see on

the screen so you i start fixing string about it when it starts

fixing string but i

i noticed other about and i've read a bit of cool so you know it'll

start making sense

you can fix usability bugs summer very easy

and that's when i start getting acquainted more with cold and i eventually made the

jump to look some record and this is this is all i mean the transition

from a writing in english writing documentation in english to courting and of all are

and using the libraries

so you should be all been to new tasks

and you know do you think's there is there is already and now of instructions

out that so try following get and then you do it you succeed at it

break that down

okay in that's what happened with the norm dictionary release i so i followed existing

we keep features and then i did it and i wrote it down so someone

else tomorrow of maybe wanting to literally skin followed the same example and set the

ball rolling

i'm just gonna hand this are working


there are basically the result of those you have what you call for against the

community because it seems like a big you know

you know

just go i hope you people or

that's the most important thing

even if you think your questions as you or you know so first for

but you still you also just

so okay well okay

well have everything

the emphasis

people developers the advanced want things a very specific way we want what sets people

apart right

so ask us

our sparse how you we wanted on and we will help

will help you put your bunched together make sure that it's actually will be accepted

and will be accepted that they'll be happy

but whatever you do don't be apathetic because if you don't care about your patch

it will get one

so you have to care about you really have to make sure like

if you believe in something party

it's fine

and make sure that you get what he wants somewhere other a that means adapting

to the T not sure why not

but if you want about fixed try to fix that

just and about

thank you

does anyone have any quest

so before in the slides you guys say that you will be you to write

good commit messages i would like you to explain to new people what any good

can mean messages

most projects most active projects have lots that's a good message is where you can

look at the smoke message of you can read that fight so i thought that

we will know what that dog

and if you actually look at the detail that

just a description

then you will be able to understand white system that way

because otherwise like trying to maintain something with methods to just like


fixed dialogue is useless because and you run the person comes looks and that does

not understand what's going on just for about

so get detail

but also be concise and precise use titles i you commit titles which are short

we wouldn't under fifty characters will and if you need to give more detail than

at the second paragraph with more detail it the commit fixes a bug

include about so the people have the right

and the same goes public so it it's a it but you fix the bottom

but still

say that the specs like to the can that's the people actually all the top

so they can look at the big about they can be realised that connected it

sometimes about have very long discussion about why something

but what i'm really useful to be able to look to figure out that

so a this in i me i gene if you subscribe to page you should

yes that all any changes that makes it and everything there's a change made which

is not trivial you should get that if occasion but yes i would use a

but all their folder actually what it will not be a buttons for to the

people who are in charge of the team that will work well actually just of

the T they will tell you which them what pages are for example the docking

station team has money page which has all the right shot but actually interesting page

to watch is that location helps take

which is have the way some

i think so i think they have pages where they what you like science fiction


so do actually a what

i was actually looking more for you know like your content like in what i

mean we have had it's in a meeting that we just put up and i

don't know what quite to wayne that be justin

what follows specific users and see what changes do making that had there is that

i just wanted to comment that there is on the week is there is the

week you don't know the to work slash recent changes speech that you can get

to from a like any page that there is like a temperate and that's a

great way to like which everybody's activity that's actually there is


i can't on you beginning an amazing job with the degradation team with involves of

course a lot of bugs and patches and commands and all of this but you

can also contributing to project the to the project in many other different place and

i'd like to know the way to start contributing in order waste beside school is

it similar to this to a lot of you present that now i have any

tips and this kind of thing

it that

basically how you really but also you say only one volunteering lot thirty

i actually became foundation member after i hope for vice that

i think to go that's just as valuable and we have what's translation

so there may the place is actually wait

thank you very much for that and i hope you have a nice thing jack

that's what