Philip Durbin 🚀 (Sep 20 2023 at 14:27): Philip Durbin 🚀 (Sep 20 2023 at 14:27):I just picked up #9919 and plan to write a first draft of a performance strategy doc. Any ideas for me?
Philip Durbin 🚀 (Sep 20 2023 at 14:27):Here's the empty doc which I'm sure will be awesome by the time we're done with it! https://docs.google.com/document/d/1Lbl0NJaoV6WOYmP-Mw6UZaA9KYSyliu2ABgs2xNdOKU/edit?usp=sharing
Philip Durbin 🚀 (Oct 04 2023 at 14:09):Yesterday we talked about it at tech hours. Please take leave comments! Thanks!
Philip Durbin 🚀 (Oct 04 2023 at 16:03):Should I add the content to the dev guide?
Oliver Bertuch (Apr 29 2026 at 15:05):Sorry for necroing this topic, but it was the only thing I could find about performance testing...
Oliver Bertuch (Apr 29 2026 at 15:06):https://github.com/IQSS/dataverse/pull/12365 was created by my just yesterday
Oliver Bertuch (Apr 29 2026 at 15:06):It introduces a framework to create Dataset fixtures, run JPA-based integration tests outside a deployment of Dataverse, and some other nice tings.
Oliver Bertuch (Apr 29 2026 at 15:07):@Philip Durbin 🚀 Looking at the dev guide, I'm puzzled where docs on this should go
Oliver Bertuch (Apr 29 2026 at 15:07):The whole performance.rst and testing.rst show is a huge box of chocolates
Oliver Bertuch (Apr 29 2026 at 15:08):Suggestions? I'm not keen on restructuring all of this, but it feels like it may be a good (but unpaid) deed to do it?
Philip Durbin 🚀 (Apr 29 2026 at 15:20):Right, so the doc was added in #10132 and here's the latest version: https://guides.dataverse.org/en/6.10.1/developers/performance.html (like you said).
Philip Durbin 🚀 (Apr 29 2026 at 15:21):You don't want to edit the doc? Too many chocolates in there? :smile:
Philip Durbin 🚀 (Apr 29 2026 at 15:21):You did a nice demo of this: * Teach Developers How to Do Performance Testing Locally :smile:
Philip Durbin 🚀 (Apr 29 2026 at 15:22):Could you put all your new stuff under a new heading under "Current Practices"? That stuff will be current once it's merged!
Oliver Bertuch (Apr 29 2026 at 17:52):So you think docs on performance testing should not go under "testing.rst" but "performance.rst", right?
Oliver Bertuch (Apr 29 2026 at 17:53):As the fixture stuff is not just about performance tests, but also about tests verifying functionality, should any docs on that go into test.rst?
Philip Durbin 🚀 (Apr 29 2026 at 17:53):As long as we cross-link stuff, I think we'll be ok. :thinking:
Oliver Bertuch (Apr 29 2026 at 17:54):Should we start moving out things from testing.rst into different pages about unit, integration, API, performance testing?
Philip Durbin 🚀 (Apr 29 2026 at 17:54):Yeah, fixtures in testing.rst makes sense.
Oliver Bertuch (Apr 29 2026 at 17:54):And only keep an introduction in testing.rst?
Philip Durbin 🚀 (Apr 29 2026 at 17:54):Absolutely. Should we start a new topic about this?
Oliver Bertuch (Apr 29 2026 at 17:55):(On a related note: should any of the stuff I wrote in https://github.com/gdcc/dataverse-recipes/blob/ed8b2a1f0cbc6766ea7ca60e354efb4619ecd942/java/update-by-flyway/README.md go into the development guide while I'm at it?)
Oliver Bertuch (Apr 29 2026 at 17:56):I somewhat hate how the developer guide is structured. The list of pages is soooo long and it's hard to find anything.
Philip Durbin 🚀 (Apr 29 2026 at 18:00):yeah, me too :disappointed:
it's grown out of control
it's probably time to rein it in
new topic for that? or rename this one?
Oliver Bertuch (Apr 29 2026 at 18:38):Maybe something for #docs ?
Philip Durbin 🚀 (Apr 29 2026 at 19:22):Sure! Reminds me of the Great Rewrite of the Installation Guide of 2016 (#2895) that @Don Sizemore might remember. :smile:
Oliver Bertuch (May 02 2026 at 00:46):I just finished the two new docs:
https://dataverse-guide--12365.org.readthedocs.build/en/12365/developers/testing/performance.html
https://dataverse-guide--12365.org.readthedocs.build/en/12365/developers/testing/fixtures.html
Last updated: May 30 2026 at 06:18 UTC