Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Onboarding task presets/templates #381

Open
lwsanty opened this issue Sep 2, 2019 · 1 comment
Open

Onboarding task presets/templates #381

lwsanty opened this issue Sep 2, 2019 · 1 comment

Comments

@lwsanty
Copy link

lwsanty commented Sep 2, 2019

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

  • on the first day of work employee doesn't know which slack channels are required
  • sometimes employee does not know which repositories relate to the team, which ones are abandoned, deprecated etc(for instance not all our frozen repos are marked as deprecated)
  • sometimes employee does not pay too much attention to find the following info in guides:
    1.1) code conventions
    1.2) CI requirements
    1.3) who's in charge for repos creation

...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

  • employee will have a cheat-sheet with all required info
  • code review troubles will be minimized
  • saved time for those who ask and answer questions

Disadvantages

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

@bluer73
Copy link
Contributor

bluer73 commented Sep 10, 2019

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants