Elaboration that might be helpful for new-comers
|Reported by:||Owned by:||nobody|
|Severity:||Normal||Keywords:||tutorial first django application|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
The following are minor changes to present documentation that might help new-comers. (An experienced person would say what follows is obvious but for new-comers this might avoid confusion.)
In settings.py you might suggest to the student they name their first file something like:
'/home/[yourname]/projects/django-tute/mysite/mysitedb'. Warn them not to have any spaces before or after the string describing the path and file name or the syncdb command which will be used later will fail because it won't be able to find the file they have specified.
There is no guarantee that the student actually has installed a database engine. For example, the student may expect that, when installing django, they have, by default installed sqlite3. I suggest you tell the student to try:
sudo apt-get install sqlite3
If it is already installed then no harm done but it will ensure the student has a database engine to work with for the purposes of this tutorial. If the student is more advanced and intends to use PostgreSQL or FirebirdSQL then, once again, no harm done.
Next, suggest to the student, once they have installed sqlite3 to start the command-line utility for sqlite3 by typing "sqlite3" in the directory in which their mysite tutorial exercise is located. Then, once in the command line utility, to type ".schema" in order to view the tables that were automatically created in the file mysitedb that was populated by the syncdb command given earlier.
Tell the student that, to exit the command line utility for sqlite3, they type CtrlZ.
Hope this is helpful.
A Perfect PC Pty Ltd