Your code can be all rainbows and unicorns, cutting and shining, but if there’s no documentation, does it even exist? Documentation can make or break your open source project. Don’t believe me? Let me tell you a story or three about writing and managing documentation for the largest open source CMS community. The WordPress documentation.

Comments

Please login to leave a comment

Milana is a vibrant speaker.
I am really interested in automating software documentation generation and even if her talk embraced the topic in a broader way, she gave me very useful tips.

Gene Surov at 12:54 on 19 May 2022

Great talk by Milana!
We need more such talks. Documentation is the key!

A nice journey of WP documentation history, its hurdles and solutions

dParadiz at 01:56 on 20 May 2022

Well prepared and presented.

Wow! I thought that WP code was complex, never thought about all the documentation systems and processes. My head is spinning. Very competent speaker, thank you!

Interesting one, maybe going through some implementation details could bring some more value.

Andrea Sprega at 22:40 on 22 May 2022

Super entertaining and very interesting, even though very specific to documentation on huge OS projects. Some more detail or a couple of actual (specific) case studies would have made it even better.

That was a very interesting insight behind the scenes of this massive project. Even if most people won't be working on projects of this size, there was a lot to take away from this talk for everyone.

The funny thing about this talk is that you can two talks for the price of one.

Yes, you can learn about documentation.

But I really also liked the insights into the inner workings of a project as big as WordPress. How are decisions made? What considerings are taken into account.

Fantastic talk.