How documentation and open communication leads to better collaboration @isabelcmdcosta 

Documentation Open Communication 

Problem ● Developers often overlook documentation ● Lack of documentation in projects and teams ● Cross teams miscommunication 

My theory ● documentation leads to a more productive and autonomous individual contributors ● accessible documentation and open communication makes for a more inclusive team 

Reflecting... 

Workplace ● In person or remote ● Fixed set of team members ● Direct reach to colleagues ● Not always transparent collaboration Open Source ● Full remote ● Diverse set of contributors ● No direct reach to individuals ● Open communication and collaboration 

Bus factor “(...) the number of team members who, if run over by a bus, would put the project in jeopardy. (...)” source: https://deviq.com/bus-factor/ 

Challenges Writing good documentation it’s like art Outdated documentation How much is enough or too much 

Effects of caring about this Autonomy Inclusive Productivity 

How can I improve ● Provide clear descriptions in pull requests and issues ● Document important decisions ● Try to avoid private conversations ● Responsibility of everyone in the team ● Put yourself into other shoes 

Thank you! Feel free to reach out! @isabelcmdcosta @isabelcosta isabelcosta.github.io