Update `Running the Selenium tests` documentation to link to django-docker-box

[colleenDunlap]

Code of Conduct

• I agree to follow Django's Code of Conduct

Feature Description

As of now in the contribution documentation for running Unit Tests, Selenium Tests section does not mention using django-docker-box to alleviate machine-based-flakiness (e.g. tests failing because your chrome settings use dark mode) in front end tests. Would like to call out Django-Docker-Box as this was pointed out to me in the discord, and it helped make a lot more of my tests pass than when I was trying to just run ./runtests.py --selenium=firefox,chrome in my django venv.

Problem

A lot of the people who love django and want to contribute come from a predominantly backend background, and thus might not be as familiar with tools like Selenium, but may want to contribute to admin functionality. This can give people a better leg to stand on when it comes to getting started.

Request or proposal

proposal

Additional Details

No response

Implementation Suggestions

Potential Wording--"Front End Tests can be very specific to browser or machine settings, as different operating systems and machines render elements differently. When running on local, you might notice tests failing when you run on a clean, up to date main, just because your laptop is on dark mode, or you're using a mac and the test is looking for windows key strokes. It can be very frustrating trying to make Selenium tests work on your specific machine. To alleviate this frustration, we recommend using Django-Docker-Box to normalize your test environment."

Could be trimmed down for simplicity to--"Front End Test Performance can be very specific to browser or machine settings, as different operating systems and machines render elements differently. To alleviate this frustration, we recommend using Django-Docker-Box to normalize your test environment."

[github-actions]

Thank you colleenDunlap for sharing your idea! We have a lot of them so please be patient. You can see the current queue here.

Community instructions

For commenters, please use the emoji reactions on the issue to express support, and/or concern easily. Please use the comments to ask questions or contribute knowledge about the idea. It is unhelpful to post comments of "I'd love this" or "What's the state of this?"

Reaction Guide

• 👍 This is something I would use
• 👎 This is something that would cause problems for me or Django
• 😕 I’m indifferent to this
• 🎉 This is an easy win

[colleenDunlap]

So what are next steps for this? Do I just make a trac ticket since the reactions are positive? @LilyAcorn @tim-schilling

[LilyAcorn]

@colleenDunlap I think you can probably just go ahead and make a PR linking to this discussion. You may get asked by a fellow to create a trac ticket too.