We're building a collaborative platform to gather and share best coding practices.
In short, it helps us highlight code snippets from the IDE (JetBrains, Visual Studio, VS Code), discuss them in Slack (or MS Teams or Discord or Mattermost), and document them with contextual examples.
> Currently, I'm using the company blog and distributing content through other channels, but it's not working out.
It could be for different reasons. One alternative would be to submit your blog post ideas to existing publications. Then cross-post them to your own domain. Always own your content.
Also, I'd recommend dev.to and/or Hashnode instead of Medium -- both platforms have a more developer-friendly reading experience (i.e. dark mode support).
> if you mean for onboarding a new software developer (both to your org and the practice of software development as a job)
In addition, I'd recommend:
Read and acknowledge the coding standards and best coding practices.
An efficient onboarding process on best coding practices would definitively save you time for your first code reviews with your team.
For example, at Promyze, we set up “Discovery Workshops,” some interactive coding challenges to discover/learn our best coding practices with concrete code snippets from the codebase.
The concept is simple:
- We built a list of best practices we want to introduce,
- We select for each practice some examples and counter-examples from the practice documentation,
- Then, each new team member will have to find in the source code where some best practices have been followed or not.
This really helps make onboarding and work more productive -- and fun.