VoV 052: Documentation with Natalia Tepluhina




Views on Vue show

Summary: <h2><strong>Sponsors</strong></h2> <ul> <li> <a href="http://sentry.io/" rel="noopener noreferrer" target="_blank">Sentry</a> use the code “devchat” for $100 credit</li> <li><a href="https://triplebyte.com/vue" rel="noopener noreferrer" target="_blank">Triplebyte</a></li> <li><a href="https://www.cachefly.com/" rel="noopener noreferrer" target="_blank">CacheFly</a></li> </ul> <h3><strong>Panel</strong></h3> <ul> <li>Divya Sasidharan</li> <li>Erik Hanchett</li> <li>Charles Max Wood</li> </ul> <p>Joined by special guest: Natalia Tepluhina</p> <h3><strong>Episode Summary </strong></h3> <p>In this episode of Views on Vue, the panelists talk to Natalia Tepluhina, Senior Frontend Developer at GitLab, about the importance of good documentation and the value of its contribution to open source in comparison to that of actual code. Natalia talks about the projects she has written documentation for, and they discuss the challenges in producing good docs. She explains three rules in making documentation comprehensive and the process involved in its creation. </p> <p>They then go into specifics about Vue documentation and discuss plugins, differences between cookbooks and guides, ways for developers to contribute to the projects, resources that they can use to learn stuff effectively and Vue Vixens curriculum vs official Vue documentation. Natalia gives an overview of Vue Vixens’ workshops (catered exclusively to women in software development) and mentions some locations around the world where they are held. She gives details about them including reasons why they choose to build mobile apps, their content and curriculum, and technical level of attendees. She also encourages women listeners to join their Slack channel (given in the links section) for more information about Vue Vixens. The panelists finally discuss representation of various groups in software development in general and the benefits of attending such workshops.</p> <h3><strong>Links</strong></h3> <ul> <li><a href="https://vuejs.org/" rel="noopener noreferrer" target="_blank">Vue.js</a></li> <li><a href="https://vuejs.org/v2/cookbook/" rel="noopener noreferrer" target="_blank">Vue cookbook</a></li> <li><a href="https://github.com/vuejs/awesome-vue" rel="noopener noreferrer" target="_blank">Awesome Vue</a></li> <li><a href="https://twitter.com/N_Tepluhina/status/1089955998855507969" rel="noopener noreferrer" target="_blank">Twitter poll on Documentation vs Code contribution</a></li> <li><a href="https://vuevixens.org/" rel="noopener noreferrer" target="_blank">Vue Vixens</a></li> <li><a href="https://slackin-fxsumkvfno.now.sh/" rel="noopener noreferrer" target="_blank">Vue Vixens Slack channel</a></li> <li><a href="https://us.vuejs.org/workshops/#vue-cli-3-plugins" rel="noopener noreferrer" target="_blank">Workshop at VueConf US</a></li> <li><a href="https://dev.to/vuevixens/building-a-desktop-app-with-vue-nwjs-1f9e" rel="noopener noreferrer" target="_blank">Building a Desktop App with Vue </a></li> <li><a href="https://twitter.com/n_tepluhina?lang=en" rel="noopener noreferrer" target="_blank">Natalia’s Twitter</a></li> <li><a href="https://github.com/NataliaTepluhina/" rel="noopener noreferrer" target="_blank">Natalia’s GitHub</a></li> <li><a href="https://www.facebook.com/ViewsonVue/" rel="noopener noreferrer" target="_blank">https://www.facebook.com/ViewsonVue/</a></li> <li><a href="https://twitter.com/viewsonvue" rel="noopener noreferrer" target="_blank">https://twitter.com/viewsonvue</a></li> </ul> <h3><strong>Picks</strong></h3> <p>Erik Hanchett:</p> <ul> <li> <a href="https://www.goodreads.com/book/show/36288143-brotopia" rel="noopener noreferrer" target="_blank">Brotopia:Breaking Up the Boys’ Club of Silicon Valley</a> </li> </ul> <p>Divya Sasidharan:</p> <ul> <li><a href="https://dev.to/vuevixens/how-to-build-a-vue-cli-plugin-3b6b" rel="noopener noreferrer" target="_blank">How to build a Vue CLI plugin by Natalia Tepluhina</a></li> </ul> <p>Natalia Tepluhina:</p> <ul> <li>Vue 2.6</li> </ul> <p>Charles Max Wood:</p> <ul> <li>Regularly spend time with just your significant other</li> <li><a href="https://chrome.google.com/webstore/detail/honey/bmnlcjabgnpnenekpadlanbbkooimhnj" rel="noopener noreferrer" target="_blank">Honey - Chrome Plugin</a></li> <li><a href="https://amzn.to/2EZCDT3" rel="noopener noreferrer" target="_blank">Withings weighing scale</a></li> </ul>