-
Notifications
You must be signed in to change notification settings - Fork 29
Blog: add interview with Anushka Saxena #401
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
Signed-off-by: Floor Drees <[email protected]>
Signed-off-by: Floor Drees <[email protected]>
content/blog/lfx-mentorship-documentation-anushka-saxena/index.md
Outdated
Show resolved
Hide resolved
content/blog/lfx-mentorship-documentation-anushka-saxena/index.md
Outdated
Show resolved
Hide resolved
content/blog/lfx-mentorship-documentation-anushka-saxena/index.md
Outdated
Show resolved
Hide resolved
Co-authored-by: Anushka Saxena <[email protected]> Signed-off-by: Floor Drees <[email protected]>
|
|
||
| Anushka is a contributor to the Cloud Native ecosystem, with a particular focus on developer-centric projects where infrastructure, documentation, and community intersect. With a background in community leadership for major cloud providers, she remains active in CNCF initiatives, open-source projects like AsyncAPI, and the broader Developer tooling landscape. | ||
|
|
||
| "One community that’s especially close to my heart is Data on Kubernetes (DoK). I first got involved during my college days as a volunteer for DoK Community Days, which was my introduction to cloud-native data workloads and open-source communities by Bart Farell, a mentor and a very well-known personality in the CNCF space. Coming back to the CloudNativePG ecosystem as a mentee later on felt like a full-circle moment!" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Probably worth a link to his linkedin?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
IMO only the interviewed person's Linkedin profile should be linked in posts.
But if Bart has a personal site, a CNCF profile page or some such, that would be fair to link.
|
|
||
| Anushka is a contributor to the Cloud Native ecosystem, with a particular focus on developer-centric projects where infrastructure, documentation, and community intersect. With a background in community leadership for major cloud providers, she remains active in CNCF initiatives, open-source projects like AsyncAPI, and the broader Developer tooling landscape. | ||
|
|
||
| "One community that’s especially close to my heart is Data on Kubernetes (DoK). I first got involved during my college days as a volunteer for DoK Community Days, which was my introduction to cloud-native data workloads and open-source communities by Bart Farell, a mentor and a very well-known personality in the CNCF space. Coming back to the CloudNativePG ecosystem as a mentee later on felt like a full-circle moment!" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| "One community that’s especially close to my heart is Data on Kubernetes (DoK). I first got involved during my college days as a volunteer for DoK Community Days, which was my introduction to cloud-native data workloads and open-source communities by Bart Farell, a mentor and a very well-known personality in the CNCF space. Coming back to the CloudNativePG ecosystem as a mentee later on felt like a full-circle moment!" | |
| "One community that’s especially close to my heart is Data on Kubernetes (DoK). I first got involved during my college days as a volunteer for DoK Community Days, which was my introduction to cloud-native data workloads and open-source communities by [Bart Farell](uhttps://www.linkedin.com/in/bart-farrell/), a mentor and a very well-known personality in the CNCF space. Coming back to the CloudNativePG ecosystem as a mentee later on felt like a full-circle moment!" |
|
|
||
| Anushka worked on automating the import of versioned documentation into the CloudNativePG docs site so that new operator releases automatically trigger the correct documentation build. It started with a major "housekeeping" task: she wrote and executed a series of Node.js utility scripts to sanitize over 60 Markdown files. This involved converting MkDocs-style admonitions to Docusaurus syntax and fixing MDX spacing issues to ensure the build wouldn't crash. | ||
|
|
||
| She also worked on the Sidebar Position Multiplier, [a script](https://github.com/cloudnative-pg/docs/pull/22) that intelligently re-indexed our documentation pages (10, 20, 30...) to allow future contributors to insert new pages without breaking the order. Finally, she helped architect the [Auto-Sync Pipeline](https://github.com/cloudnative-pg/docs/pull/18), a GitHub Action that automatically pulls documentation from the main repo into the docs repo whenever a new release is published. This involved writing a reusable import script, integrating it into a GitHub Actions workflow triggered by upstream releases, and validating the output in a Docusaurus-based documentation setup. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The PR cloudnative-pg/docs#22 is closed and has nothing like a script, just a change in some links and a config :S
|
|
||
| Anushka worked on automating the import of versioned documentation into the CloudNativePG docs site so that new operator releases automatically trigger the correct documentation build. It started with a major "housekeeping" task: she wrote and executed a series of Node.js utility scripts to sanitize over 60 Markdown files. This involved converting MkDocs-style admonitions to Docusaurus syntax and fixing MDX spacing issues to ensure the build wouldn't crash. | ||
|
|
||
| She also worked on the Sidebar Position Multiplier, [a script](https://github.com/cloudnative-pg/docs/pull/22) that intelligently re-indexed our documentation pages (10, 20, 30...) to allow future contributors to insert new pages without breaking the order. Finally, she helped architect the [Auto-Sync Pipeline](https://github.com/cloudnative-pg/docs/pull/18), a GitHub Action that automatically pulls documentation from the main repo into the docs repo whenever a new release is published. This involved writing a reusable import script, integrating it into a GitHub Actions workflow triggered by upstream releases, and validating the output in a Docusaurus-based documentation setup. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The PR cloudnative-pg/docs#18 it's a rename of from dev to devel not a pipeline
jsilvela
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
IMO the paragraphs could use more punctuation, some of the sentences feel run-on. And also perhaps focus on making fewer points.
Nice work on Docusaurus by the way!
| --- | ||
|
|
||
| In the summer we wrote about how CloudNativePG was back for the September- | ||
| October-November LFX term with [several projects for mentoring](https://cloudnative-pg.io/blog/2025-term3-lfx-cncf-mentorship/). One of them was around the Docs. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"projects for mentoring" I think can be misread.
Maybe we could rephrase to "... CloudNativePG was back for the September-October-November term of LFX Mentorship with several projects.
|
|
||
| ## Start at the beginning | ||
|
|
||
| Anushka has always been motivated by curiosity and the desire to understand how systems work. "Over time, open source became a natural extension of that curiosity because it offered a way to learn by contributing, asking questions, and building things that real people use." What really drew her in was when she realized that great software often faces issues not because of poor engineering, but because it’s hard to understand or adopt. "That realization shaped my interest in documentation modernization and contributor experience as first-class technical problems." |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Meta-comment: because of no line breaks, my comment on the last line of this paragraph seems to apply to the whole paragraph :/
| Anushka has always been motivated by curiosity and the desire to understand how systems work. "Over time, open source became a natural extension of that curiosity because it offered a way to learn by contributing, asking questions, and building things that real people use." What really drew her in was when she realized that great software often faces issues not because of poor engineering, but because it’s hard to understand or adopt. "That realization shaped my interest in documentation modernization and contributor experience as first-class technical problems." | |
| Anushka has always been motivated by curiosity and the desire to understand how systems work. "Over time, open source became a natural extension of that curiosity because it offered a way to learn by contributing, asking questions, and building things that real people use." What really drew her in was when she realized that great software often faces issues not because of poor engineering, but because it’s hard to understand or adopt. "That realization shaped my interest in documentation and contributor experience as first-class technical problems." |
The way it's written, "document modernization and contributor ..." would need a comma before "and" to help parsing.
But I also think "modernization" is not "a first-class problem". Documentation is.
|
|
||
| Anushka is a contributor to the Cloud Native ecosystem, with a particular focus on developer-centric projects where infrastructure, documentation, and community intersect. With a background in community leadership for major cloud providers, she remains active in CNCF initiatives, open-source projects like AsyncAPI, and the broader Developer tooling landscape. | ||
|
|
||
| "One community that’s especially close to my heart is Data on Kubernetes (DoK). I first got involved during my college days as a volunteer for DoK Community Days, which was my introduction to cloud-native data workloads and open-source communities by Bart Farell, a mentor and a very well-known personality in the CNCF space. Coming back to the CloudNativePG ecosystem as a mentee later on felt like a full-circle moment!" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
IMO only the interviewed person's Linkedin profile should be linked in posts.
But if Bart has a personal site, a CNCF profile page or some such, that would be fair to link.
|
|
||
| She also worked on the Sidebar Position Multiplier, [a script](https://github.com/cloudnative-pg/docs/pull/22) that intelligently re-indexed our documentation pages (10, 20, 30...) to allow future contributors to insert new pages without breaking the order. Finally, she helped architect the [Auto-Sync Pipeline](https://github.com/cloudnative-pg/docs/pull/18), a GitHub Action that automatically pulls documentation from the main repo into the docs repo whenever a new release is published. This involved writing a reusable import script, integrating it into a GitHub Actions workflow triggered by upstream releases, and validating the output in a Docusaurus-based documentation setup. | ||
|
|
||
| "A key part of my approach was treating documentation as production infrastructure: iterating locally, validating assumptions, opening pull requests, and refining solutions based on maintainer feedback. The goal was not just to make things work once, but to reduce long-term manual effort and make the documentation workflow more contributor-friendly and reliable." |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The second part of this paragraph "The goal ..." really needs some commas to help digest the ands.
|
|
||
| Anushka says that working with mentors Gabriele, Francesco, and Leonardo was the highlight of her mentorship. "We had a very collaborative rhythm!" Through Slack, GitHub issues, weekly sync calls and pull requests, the team was responsive and generous with feedback, making it easy to iterate and improve. Anushka appreciated that discussions were clear, constructive, and focused on long-term project health rather than quick fixes. "Gabriele, Francesco, and Leonardo constantly provided the overall high-level vision that helped me see how my small scripts would affect the project as a whole." | ||
|
|
||
| Seeing my contributions become part of CloudNativePG’s documentation workflow and knowing they would support future releases, is very rewarding. The trust the maintainers placed in me by always encouraging me to take ownership of increasingly complex pieces of the docs pipeline rather than limiting my scope as “just a mentee”, really made me feel included." |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This paragraph is complex and has a crammed feeling. Some ideas.
| Seeing my contributions become part of CloudNativePG’s documentation workflow and knowing they would support future releases, is very rewarding. The trust the maintainers placed in me by always encouraging me to take ownership of increasingly complex pieces of the docs pipeline rather than limiting my scope as “just a mentee”, really made me feel included." | |
| Seeing my contributions become part of CloudNativePG’s documentation workflow, and knowing they would support future releases, is very rewarding. The trust the maintainers placed in me, and their encouragement to take ownership of complex pieces of the pipeline, really made me feel included; not "just a mentee." |
|
|
||
| ## What’s next | ||
|
|
||
| While debugging the MDX sanitization, Anushka realized that Docusaurus is much stricter than standard Markdown. A failed build because of a single unclosed `<td>` tag taught her about how modern documentation engines render content as React components, and changed how she now views "docs as code". "Also, realizing how deeply documentation is tied to release engineering made me ponder upon how docs aren’t just reference material, but a critical part of user trust, operational safety, and adoption, especially for something as production-critical as Kubernetes-native PostgreSQL!" Certainly something she'll be taking into her next projects. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a "lessons learned" paragraph, and I think like the previous one, it feels a bit crammed. IMO should be condensed. I like the unclosed td anecdote.
@SaxenaAnushka102 let me know if this still reads like you. I loved the detail in your answers!
Will fix width after review.