12 ms·
I can speak to the onboarding on the Eng side: * Good readmes. Every project is required to have a readme.md that's not boilerplate. Since every team is differ
by gee_totes 8y ago
I can speak to the onboarding on the Eng side:
* Good readmes. Every project is required to have a readme.md that's not boilerplate. Since every team is different, the quality of the readmes range from well-organized to stream of consciousness. But the point of the readme is that it's the very first document when on-boarding and contains instructions to set the project up, as well as git blame information so the new person can find the right person to bug for more information.
* Pair programming. There's no silver bullet for onboarding and you just need to accept the friction. Having new devs pair with experienced devs as they go through their daily workflow is the most useful way, IMHO, to get comfortable with the codebase and transmit cultural norms and values.
- afarrell 8y agoOne thing that I find helpful in readmes is an ordered list of pointers to particular parts of the codebase that one should read to get an understanding of the overall structure. This is particularly helpful if the walkthrough of the conceptual framework of the project hosted externally on sites like https://docs.djangoproject.com/en/2.0/intro/tutorial01/ https://docs.djangoproject.com/en/2.0/intro/tutorial01/ because that conceptual framework was designed specifically for this project.