Documentation Admin classes with raw_id_fields
|Reported by:||Owned by:||nobody|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
The Django documentation is very unclear on the raw_id_fields feature. Please, describe the feature better, and add a screenshot showing a sample table of raw_id_fields. Also, explain the magnifying glass chooser aspect.
Most importantly, the documentation seems to treat raw_id_fields like comma-separated lists of IDs; like 1,2,3; rather than one ID per field. Also, note that the user must input the primary key, and the admin coder has to show the user that key somehow.
There should be more about Inline admin classes as compared to model Admin classes and raw_id_fields. Also, describe more on ForeignKey, ManyToMany, and ManyToMany with through.
I have used raw_id_fields in an Inline admin class to add several ManyToMany items for the first time. My understanding of raw_id_fields is limited, and my suggestions above may be plain wrong.