Documentation and Migration: From Vue 2 to Vue 3 (with Natalia Tepluhina)

Aug 8, 2024

Ask episode

Chapters

Transcript

Episode notes

For the 20th episode we surprise you with a "in-person" podcast episode!

Alex is joined by Principal Engineer and Vue Core Team Member Natalia Tepluhina to talk about two important topics - Documentation and the Migration from Vue 2 to Vue 3.

Learn in this episode what Natalia does in the core team, how difficult writing docs is and how to improve your doc writing skills. Also, gain insights in how GitLab's migration from Vue 2 to Vue 3 is going and get invaluable tips if you also have to migrate a project over!

Enjoy the episode!

Chapters

(00:00) - Welcome to DejaVue!
(01:32) - When did you start using Vue.js?
(02:42) - How could you introduce Vue at work?
(04:43) - Joining GitLab
(07:15) - Getting into public speaking
(10:05) - Memorable moments as a speaker
(16:22) - Moving to Amsterdam
(18:22) - Being part of the Vue.js Core Team
(20:27) - (Not) Documenting Vue Methods
(22:21) - $parent in Vue 2
(22:59) - AI as the new docs?
(25:00) - Regular Contributors to the Vue docs
(26:14) - Is writing docs is easy?
(31:45) - Documenting Vue 3 at release
(34:04) - Documentation as a garden
(37:00) - Separating Options and Composition API docs
(38:20) - Preferring the Options API for huge teams?
(41:49) - Inline Composables and other architectural patterns
(45:35) - Overusing Watchers
(46:57) - People - Share your thoughts and patterns!
(48:39) - Vue.js DE Conference
(49:14) - Migration from Vue 2 to Vue 3
(50:10) - How the component library blocks migration
(54:10) - Updating Unit tests during migration
(55:16) - No CAPI during migration
(57:13) - Migration of big old projects
(58:45) - Responsibility of library authors
(01:05:01) - Vue 3 Breaking changes
(01:06:31) - Will the migration ever end?
(01:07:48) - Other tips for migrating
(01:09:19) - Migrating without tests
(01:10:45) - Rewrite vs Migration?
(01:11:35) - Not migrating at all?
(01:13:54) - No CAPI during migration?
(01:15:58) - New questions with CAPI
(01:16:58) - Natalia back on stage at a conference?
(01:18:16) - What could the Vue team have done better?
(01:20:21) - Nuxt Tips Collection
(01:21:00) - Wrapping up

Links and Resources

$10 off for Michael's Nuxt Tips Collection* with this link and the code DEJAVUE
10% discount for the vue.js de Conf in Bonn, Germany* with code DEJAVUE

Links marked with * are affiliate links. We get a small commission when you register for the service through our link. This helps us to keep the podcast running. We only include affiliate links for services mentioned in the episode or that we use ourselves.