Browse Source

Updated readme #375

Rafał Pitoń 11 years ago
parent
commit
09ea3952b5
2 changed files with 15 additions and 9 deletions
  1. 10 7
      README.rst
  2. 5 2
      docs/setup_maintenance.rst

+ 10 - 7
README.rst

@@ -16,7 +16,7 @@ Misago
 
 
 Misago aims to be complete, featured and modern forum solution that has no fear to say 'NO' to common and outdated opinions about how forum software should be made and what it should do.
 Misago aims to be complete, featured and modern forum solution that has no fear to say 'NO' to common and outdated opinions about how forum software should be made and what it should do.
 
 
-If you can run Python apps on your hosting and you are looking for modern solution using latest paradigms in web development, or you are Django developer and forum is going to be core component of your next project then Misago is option for you!
+If you can run Python apps on your hosting and you are looking for modern solution using latest paradigms in web development, or you are Django developer and forum is going to be core component of your next project then Misago is option for you.
 
 
 * **Homepage:** http://misago-project.org/
 * **Homepage:** http://misago-project.org/
 * **Documentation:** http://misago.readthedocs.org/en/latest/
 * **Documentation:** http://misago.readthedocs.org/en/latest/
@@ -26,27 +26,30 @@ If you can run Python apps on your hosting and you are looking for modern soluti
 Installing and updating
 Installing and updating
 -----------------------
 -----------------------
 
 
-Please note that branch *future* is used for project's codebase cleanup and is not functional at the time of this writing. If you want to give Misago a spin, feel free to play with one of `previous releases <https://github.com/rafalp/Misago/releases>`_.
+Please note that branch *future* is used for project's codebase cleanup and is not functional at the time of writing. If you want to give Misago a spin, feel free to play with one of `previous releases <https://github.com/rafalp/Misago/releases>`_.
 
 
 To install Misago setup and activate virtual environment and then fire following commands::
 To install Misago setup and activate virtual environment and then fire following commands::
 
 
     python setup.py install
     python setup.py install
     misago-start.py testforum
     misago-start.py testforum
 
 
-Those commands will install Misago in your virtual environment and make pre-configured Misago site for you named "testforum" using "misago-start.py" script available successfull installation.
+This will install Misago in your virtual environment and will make pre-configured Misago site for you named "testforum".
 
 
-Now cd test forum and initialize database by using syncdb and migrate commands using manage.py::
+Now cd to this testforum and initialize database by using migrate commands provided by manage.py admin utility::
 
 
     cd testforum
     cd testforum
-    python manage.py syncdb
     python manage.py migrate
     python manage.py migrate
 
 
+Next, call createsuperuser command to create super admin in database::
+
+    python manage.py createsuperuser
+
 Finally start development server using runserver command::
 Finally start development server using runserver command::
 
 
     python manage.py runserver
     python manage.py runserver
 
 
 
 
-If server starts, you should be able to visit 127.0.0.1:8000 in your browser and see simple placeholder response from Misago, however as work on this branch is underway revisions may frequently introduce changes that will break runserver.
+If nothing is wrong with your setup, developer server will start enabling you to visit 127.0.0.1:8000 in your browser and see incomplete page from Misago.
 
 
 
 
 Bug reports, features and feedback
 Bug reports, features and feedback
@@ -62,7 +65,7 @@ Contributing
 
 
 If you have fixed spelling mistake, wrote new tests or fixed a bug, feel free to open pull request.
 If you have fixed spelling mistake, wrote new tests or fixed a bug, feel free to open pull request.
 
 
-Many issues are open for takes. If you've found one you feel you could take care of, please announce your intent in issue discussion before you start working. That way situations when more than one person works on solving same issue can be avoided.
+Many issues are open for takers. If you've found one you feel you could take care of, please announce your intent in issue discussion before you start working. That way situations when more than one person works on solving same issue can be avoided.
 
 
 
 
 Authors
 Authors

+ 5 - 2
docs/setup_maintenance.rst

@@ -55,11 +55,14 @@ Open "settings.py" in your code editor of choice and give a look in values liste
 .. note::
 .. note::
    To simplify setup process, by default "settings.py" file contains only most basic settings that are needed for your site to run, with everything else being set for you automatically at the beginning of file.
    To simplify setup process, by default "settings.py" file contains only most basic settings that are needed for your site to run, with everything else being set for you automatically at the beginning of file.
 
 
-Move back to directory with manage.py and use it to initialize Misago database by firing following following commands::
+Move back to directory with manage.py and use it to initialize Misago database by firing migrate::
 
 
-    python manage.py syncdb
     python manage.py migrate
     python manage.py migrate
 
 
+Next, call createsuperuser command to create super admin in database::
+
+    python manage.py createsuperuser
+
 Finally, start development server using "runserver" command::
 Finally, start development server using "runserver" command::
 
 
     python manage.py runserver
     python manage.py runserver