id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
34043	"Doc ""Writing your first patch for Django"" doesn't explain how to contribute to the admin UI"	Hugo Herter	Sarah Boyce	"The documentation [https://docs.djangoproject.com/en/dev/intro/contributing/ Writing your first patch for Django ] is aimed to help new contributors to contribute to Django.

This documentation is focused on the test suite, and does not include any help on how to run the Admin. This makes it difficult for newcomers to contribute to UI enhancements of the Django Admin, or to test and review changes in pull requests that include UI changes.

This would make it much easier to work on tickets such as #34033, #34036, #34037, ...


== Proposal

Add a section in this page that explains how to automatically start a sample project pre-populated with enough test data to test most builtin UI features and widgets.

I was recommended by @thibaudcolas to use [https://github.com/knyghty/django-admin-demo this django-admin-demo] project to test the admin. That project appears to be a good start, but requires dependencies unrelated to Django such as `spotipy`, and is hosted by a third party instead of being (part of) an official Django repository.

== Questions

Would the sample project be part of the official Django repository or be a different repository ? 

Does Django have test suites and tooling to keep track of UI changes automatically ?
Something like https://percy.io/ (proprietary, cloud, sketchy example)."	New feature	closed	Documentation	dev	Normal	fixed		Thibaud Colas Sarah Boyce	Ready for checkin	1	0	0	0	0	1