1) Will data researchers ever need to know the actual table name, or can they use "student_courseenrollment" to get everything that they need when working with edX staff?
2) Are any of the other audiences of this guide (including internal edX users) going to need to know that the internal table name is different from the data package name?
I think the answer to 2 is definitely yes, and the answer to 1 may be yes, so sure, let's add it. Is it completely straightforward to add a note that "In the edX database, the SQL table that stores this data is named user_id_map."?