docs: Rework the Testing section for 4.0 - #721
Open
developerjamiu wants to merge 19 commits into
Open
Conversation
…e3-section7-operations # Conflicts: # docs/06-concepts/01-server-fundamentals/02-running-your-server.md
…e3-section7-operations
marcelomendoncasoares
added a commit
to marcelomendoncasoares/serverpod_docs
that referenced
this pull request
Jul 27, 2026
Zfinix
reviewed
Jul 28, 2026
Zfinix
reviewed
Jul 28, 2026
Zfinix
reviewed
Jul 28, 2026
Zfinix
reviewed
Jul 28, 2026
Zfinix
reviewed
Jul 28, 2026
Zfinix
left a comment
Contributor
There was a problem hiding this comment.
Two renamed URLs here, worth getting the redirects in with the rest.
…e3-section7-operations
…e3-section8-testing
…e3-section8-testing
…on7-operations # Conflicts: # docs/06-concepts/01-server-fundamentals/02-running-your-server.md
…e3-section8-testing
…on8-testing # Conflicts: # docs/06-concepts/08-testing/03-advanced-examples.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Section-by-section rework of the Testing concept pages for Serverpod 4.0, following Data & the database (#696), Web server (#711), Scheduling (#719), and Operations (#720). The section keeps its linear shape but splits reference material out of the walkthrough, and every claim was checked against the framework source.
Stacked on #720, so it targets that branch and shows only its own changes. GitHub retargets it to
mainonce #720 merges.Changes
withServerpodoption, so the reference table no longer interrupts a page being read top to bottom.Corrections
database.dataPathinconfig/test.yaml, sodart teststarts its own PostgreSQL and the compose services are never contacted.sessionBuilder.build(), and recommended movingbuild()intosetUpAllto reduce connections. The instance is constructed whenwithServerpodis called and the connection opens insetUpAllregardless, so the workaround changed nothing.serverDirectory, and presentedapplyMigrations,rollbackDatabase, andruntimeParametersBuilderas always available. Without a database they are not generated at all, so passing one is a compile error.flushEventQueueexample passed a builtSessionwhere the generated API takes the session builder.copyWithdefaults were documented as fixed values; both parameters inherit from the builder they are called on.Session,Scope, orConstantnow say where they come from.Notes
/concepts/testing/the-basics,/concepts/testing/best-practises) need redirects at the GA cutover; recorded with the rest of the redirect work.serverpod_testdoc comment forflushEventQueuehas the samesession/sessionBuildererror corrected here, the start-timeout message tells users to rundocker compose up, andworking-with-endpoints.mdhas a pre-existing broken link to this section.