everyone
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
so
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
my
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
and
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
that
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
small
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
let's
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
had
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
project
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
program
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
yourself
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
so
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
now
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
and
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
okay
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
say
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
really
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
okay
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