src-d / guide

Aiming to be a fully transparent company. All information about source{d} and what it's like to work here.
Creative Commons Attribution Share Alike 4.0 International
293 stars 102 forks source link

Onboarding task presets/templates #381

Open lwsanty opened 5 years ago

lwsanty commented 5 years ago

Pre-history

1) a couple of months ago @bluer73 started a practice of one month post-onboarding feedback call 2) often developers have onboarding tasks that help them to be involved into process more smoothly 3) current repo with guides(from code conventions to company culture) that we refer freshmen to 4) additional info can be obtained via direct texting with the team(s)

Problems

...and so on.

This leads to overcome through mistakes path. I believe we can workaround it.

Possible solution that could ease onboarding routine

We can create onboarding tasks template that will gather most of the required info for development at one place, so we could minimize the following questions amount.

Template should be created for each team.

Template's content

TBD, I wanted this issue to be a field of discussion

Abstractly it could look like this:

Team slack channels: @dev-..., @su-...
Required slack channels: ...
Team lead: ...
Repositories your team is working on:...

Onboarding task: #1234
Please take this info into account:
- you need to create a repository/to work with this repository, to make it happen...
- you may need to access cluster(link to manual), and contact infra team(@infras-channel)
- current repository is written in go, please consider using this convention (link)
- you need to setup CI for current repository, we do it in a such way (link)
- policy of PR reviews (link)
- docs
...

Advantages

Disadvantages

It may be non-constant sometimes, depending on the specification of the issue, but we can generalize it in some way.

bluer73 commented 5 years ago

@lwsanty really good idea- I can work with each team lead on this and then make sure they are as generalised as possible overall