1. Rajeesh Nair
  2. Django-monitor

Commits

Rajeesh Nair  committed 517834f

More concise documentation.

  • Participants
  • Parent commits 367d024
  • Branches default

Comments (0)

Files changed (28)

File docs/build/doctrees/admin_howto.doctree

Binary file modified.

File docs/build/doctrees/dev_howto.doctree

Binary file modified.

File docs/build/doctrees/environment.pickle

Binary file modified.

File docs/build/doctrees/usage.doctree

Binary file removed.

File docs/build/html/_images/custom_changelist4.jpg

Removed
Old image

File docs/build/html/_images/moderation_actions.jpg

Added
New image

File docs/build/html/_images/moderation_changelink.jpg

Added
New image

File docs/build/html/_images/moderation_filter.jpg

Added
New image

File docs/build/html/_images/moderation_queue.jpg

Added
New image

File docs/build/html/_images/moderation_status_column.jpg

Added
New image

File docs/build/html/_sources/admin_howto.txt

View file
 How to use (for admin-users)
 =============================
 
-All moderation activities can be performed from within the admin changelist
-itself. The changelist view of a moderated model will look like that in the
-screen-shot below :
-
-.. image:: _static/custom_changelist.jpg
-   :scale: 70
-   :alt: Change-list
+All moderation activities can be performed from within the admin interface
+itself. Following sections describe the process in detail. The figures are
+based on an example app, ``TestApp`` with models like ``Author`` and ``Book``.
 
 Who can moderate
 ==================
 
-Django-monitor creates a moderate permission for each moderated model. Only
-those users with required permission can moderate any object of a particular
-model. The superuser must assign those permissions to the appropriate users
-as they would do with other commonly found permissions.
+Django-monitor creates a moderate permission for each moderated model.
+To moderate any object of a model, user need to have permission for that
+particular model. The superuser must assign those permissions to the
+appropriate users as they would do with other permissions.
 
 What to moderate & from where
 ===============================
 there. For moderated models, we add one more column, ``status`` to the right of
 each row. That column, as its name indicates, displays the current moderation
 status of each object you see in the list. This helps you to identify the
-pending as well as challenged objects. Also, you can filter the objects by their
-``moderation status`` using the filter options provided in the box to the right
-of change-list. Refer to the screen-shot given above.
+pending as well as challenged objects. See the figure:
+
+.. image:: _static/moderation_status_column.jpg
+   :alt: Status column
+
+Also, you can filter the objects by ``moderation status`` using the options
+provided in the box to the right of change-list. Refer to the figure below:
+
+.. image:: _static/moderation_filter.jpg
+   :alt: Filter
 
 You need not regularly visit change-lists of all models to know whether there
 are any objects to be moderated. ``Moderation Queue`` is the shortcut for this.
-It will summarize the moderation status for all models in one page. Click on
-the ``Moderation Queue`` change-link under the ``Monitor`` app in your admin
-home page. You can see the number of pending and challenged objects for each
-moderated model arranged in a nice table in the resulting page. Clicking on
-each number will lead you to the corresponding change-list filtered by the
-respective status. eg, if you clicked on the number of pending objects of the
-model, say, `Book`, the change-list showing all pending book objects will be
-loaded.
+It will summarize the moderation status for all models in one page. In your
+admin home page there is a ``Moderation Queue`` change-link under ``Monitor``
+app. See the figure:
+
+.. image:: _static/moderation_changelink.jpg
+   :alt: Moderation Queue change-link
+
+Clicking on it will lead you to a moderation queue page from where you can see
+a nice table listing out the number of pending and challenged objects for each
+moderated model. An example figure is given below:
+
+.. image:: _static/moderation_queue.jpg
+   :scale: 70
+   :alt: Moderation Queue page
+
+Note that the pointer points to the number `2` in the figure. This number
+indicates that there are 2 pending ``Author`` objects now. Click on that number
+and you will be lead to the ``Author`` change-list where you can see both of the
+pending objects. Similarly, you can find pending/challenged objects of any model
+from here.
 
 How to moderate
 =================
 
 Moderation is performed through 3 special change-list actions. They are,
 ``Approve selected``, ``Challenge selected`` and ``Reset selected to pending``.
+The figure below shows the actions found in ``Author`` changelist:
+
+.. image:: _static/moderation_actions.jpg
+   :alt: Moderation actions
+
 If the manager selects few objects, choose the action ``Approve selected`` and
-press ``Go``, those objects will get approved. Similarly, one can challenge some
+press ``Go``, those objects will get approved. Similarly, one can challenge 
 objects too. Once some objects get challenged, the non-managers may check them
 again and make required corrections. After that, they can reset the status to
 ``In pending`` using the action, ``Reset selected to pending`` so that their

File docs/build/html/_static/custom_changelist.jpg

Removed
Old image

File docs/build/html/_static/moderation_actions.jpg

Added
New image

File docs/build/html/_static/moderation_changelink.jpg

Added
New image

File docs/build/html/_static/moderation_filter.jpg

Added
New image

File docs/build/html/_static/moderation_queue.jpg

Added
New image

File docs/build/html/_static/moderation_status_column.jpg

Added
New image

File docs/build/html/admin_howto.html

View file
             
   <div class="section" id="how-to-use-for-admin-users">
 <span id="admin-howto"></span><h1>How to use (for admin-users)<a class="headerlink" href="#how-to-use-for-admin-users" title="Permalink to this headline">¶</a></h1>
-<p>All moderation activities can be performed from within the admin changelist
-itself. The changelist view of a moderated model will look like that in the
-screen-shot below :</p>
-<a class="reference internal image-reference" href="_images/custom_changelist4.jpg"><img alt="Change-list" src="_images/custom_changelist4.jpg" style="width: 715.4px; height: 396.9px;" /></a>
+<p>All moderation activities can be performed from within the admin interface
+itself. Following sections describe the process in detail. The figures are
+based on an example app, <tt class="docutils literal"><span class="pre">TestApp</span></tt> with models like <tt class="docutils literal"><span class="pre">Author</span></tt> and <tt class="docutils literal"><span class="pre">Book</span></tt>.</p>
 <div class="section" id="who-can-moderate">
 <h2>Who can moderate<a class="headerlink" href="#who-can-moderate" title="Permalink to this headline">¶</a></h2>
-<p>Django-monitor creates a moderate permission for each moderated model. Only
-those users with required permission can moderate any object of a particular
-model. The superuser must assign those permissions to the appropriate users
-as they would do with other commonly found permissions.</p>
+<p>Django-monitor creates a moderate permission for each moderated model.
+To moderate any object of a model, user need to have permission for that
+particular model. The superuser must assign those permissions to the
+appropriate users as they would do with other permissions.</p>
 </div>
 <div class="section" id="what-to-moderate-from-where">
 <h2>What to moderate &amp; from where<a class="headerlink" href="#what-to-moderate-from-where" title="Permalink to this headline">¶</a></h2>
 there. For moderated models, we add one more column, <tt class="docutils literal"><span class="pre">status</span></tt> to the right of
 each row. That column, as its name indicates, displays the current moderation
 status of each object you see in the list. This helps you to identify the
-pending as well as challenged objects. Also, you can filter the objects by their
-<tt class="docutils literal"><span class="pre">moderation</span> <span class="pre">status</span></tt> using the filter options provided in the box to the right
-of change-list. Refer to the screen-shot given above.</p>
+pending as well as challenged objects. See the figure:</p>
+<img alt="Status column" src="_images/moderation_status_column.jpg" />
+<p>Also, you can filter the objects by <tt class="docutils literal"><span class="pre">moderation</span> <span class="pre">status</span></tt> using the options
+provided in the box to the right of change-list. Refer to the figure below:</p>
+<img alt="Filter" src="_images/moderation_filter.jpg" />
 <p>You need not regularly visit change-lists of all models to know whether there
 are any objects to be moderated. <tt class="docutils literal"><span class="pre">Moderation</span> <span class="pre">Queue</span></tt> is the shortcut for this.
-It will summarize the moderation status for all models in one page. Click on
-the <tt class="docutils literal"><span class="pre">Moderation</span> <span class="pre">Queue</span></tt> change-link under the <tt class="docutils literal"><span class="pre">Monitor</span></tt> app in your admin
-home page. You can see the number of pending and challenged objects for each
-moderated model arranged in a nice table in the resulting page. Clicking on
-each number will lead you to the corresponding change-list filtered by the
-respective status. eg, if you clicked on the number of pending objects of the
-model, say, <cite>Book</cite>, the change-list showing all pending book objects will be
-loaded.</p>
+It will summarize the moderation status for all models in one page. In your
+admin home page there is a <tt class="docutils literal"><span class="pre">Moderation</span> <span class="pre">Queue</span></tt> change-link under <tt class="docutils literal"><span class="pre">Monitor</span></tt>
+app. See the figure:</p>
+<img alt="Moderation Queue change-link" src="_images/moderation_changelink.jpg" />
+<p>Clicking on it will lead you to a moderation queue page from where you can see
+a nice table listing out the number of pending and challenged objects for each
+moderated model. An example figure is given below:</p>
+<a class="reference internal image-reference" href="_images/moderation_queue.jpg"><img alt="Moderation Queue page" src="_images/moderation_queue.jpg" style="width: 562.8px; height: 141.4px;" /></a>
+<p>Note that the pointer points to the number <cite>2</cite> in the figure. This number
+indicates that there are 2 pending <tt class="docutils literal"><span class="pre">Author</span></tt> objects now. Click on that number
+and you will be lead to the <tt class="docutils literal"><span class="pre">Author</span></tt> change-list where you can see both of the
+pending objects. Similarly, you can find pending/challenged objects of any model
+from here.</p>
 </div>
 <div class="section" id="how-to-moderate">
 <h2>How to moderate<a class="headerlink" href="#how-to-moderate" title="Permalink to this headline">¶</a></h2>
 <p>Moderation is performed through 3 special change-list actions. They are,
 <tt class="docutils literal"><span class="pre">Approve</span> <span class="pre">selected</span></tt>, <tt class="docutils literal"><span class="pre">Challenge</span> <span class="pre">selected</span></tt> and <tt class="docutils literal"><span class="pre">Reset</span> <span class="pre">selected</span> <span class="pre">to</span> <span class="pre">pending</span></tt>.
-If the manager selects few objects, choose the action <tt class="docutils literal"><span class="pre">Approve</span> <span class="pre">selected</span></tt> and
-press <tt class="docutils literal"><span class="pre">Go</span></tt>, those objects will get approved. Similarly, one can challenge some
+The figure below shows the actions found in <tt class="docutils literal"><span class="pre">Author</span></tt> changelist:</p>
+<img alt="Moderation actions" src="_images/moderation_actions.jpg" />
+<p>If the manager selects few objects, choose the action <tt class="docutils literal"><span class="pre">Approve</span> <span class="pre">selected</span></tt> and
+press <tt class="docutils literal"><span class="pre">Go</span></tt>, those objects will get approved. Similarly, one can challenge
 objects too. Once some objects get challenged, the non-managers may check them
 again and make required corrections. After that, they can reset the status to
 <tt class="docutils literal"><span class="pre">In</span> <span class="pre">pending</span></tt> using the action, <tt class="docutils literal"><span class="pre">Reset</span> <span class="pre">selected</span> <span class="pre">to</span> <span class="pre">pending</span></tt> so that their

File docs/build/html/objects.inv

Binary file modified.

File docs/build/html/searchindex.js

View file
-Search.setIndex({objects:{},terms:{origin:[0,3],all:[0,2,3],code:[0,1],shot:2,help:[0,1,2],just:[0,3],show:2,also:[2,3],when:[0,3],yourmodeladmin:0,approv:[0,2,3],supplement:0,through:2,particualr:2,permiss:[2,3],skip:3,identifi:2,still:0,row:2,current:[0,2,3],onli:[0,2],monitoradmin:0,monitor:[0,1,2,3],field:[0,3],field2:0,copi:3,field1:0,activ:[0,2],specif:3,shortcut:2,should:0,add:[2,3],pend:[0,2,3],about:[0,1,3],under:2,set:[0,3],must:2,might:0,app:[2,3],is_challeng:0,"case":0,non:2,sourc:3,rememb:0,thei:[0,2],get:[0,2,3],read:[0,3],prefer:0,watch:0,regularli:2,know:[0,2],got:3,press:[2,3],requir:[0,2,3],introduct:[1,3],well:[2,3],term:3,verifi:[0,2],name:[0,2,3],organ:0,hook:[0,1],signal:0,possibl:0,list:[0,2],correct:2,separ:0,"default":[0,2],follow:0,either:0,each:[0,2,3],found:2,get_monitor_entri:0,where:[1,2],page:[1,2,3],view:2,pleas:0,prevent:[0,3],right:2,nice:2,mai:[0,2,3],regist:0,replac:0,creation:[0,1],some:[0,2,3],is_approv:0,see:[0,2],result:2,pass:0,download:3,home:2,click:2,special:[0,1,2],after:[0,2],index:1,what:[0,1,2],appear:2,lead:2,section:0,below:[0,2],summar:2,content:1,delet:[0,3],written:0,version:3,leav:0,select:[2,3],method:0,django:[0,1,2,3],"import":0,paramet:0,"public":0,modeladmin:0,integr:3,signatur:0,particular:[0,2,3],full:0,deriv:0,kei:0,whose:0,post:[0,1],screen:2,usag:0,given:2,here:[0,3],like:2,job:3,let:0,arrang:2,put:0,path:3,gatekeep:3,becom:3,modifi:0,refer:[0,2],valu:[0,3],box:2,both:0,search:1,is_pend:0,column:2,someth:0,manag:[0,2,3],queue:[0,2],related_nam:0,place:3,monitorentri:0,fals:0,charfield:0,chang:[0,2,3],mean:3,handler_func:0,commonli:2,load:2,readonly_field:0,own:3,onc:[0,2],modul:1,within:[2,3],reset_to_pend:0,number:2,automat:3,two:0,distinguish:3,alreadi:3,done:0,org:3,respect:2,installed_app:3,assum:0,your:[0,2,3],middlewar:0,differ:[0,3],rajeesh:3,from:[0,1,2,3],describ:0,would:[0,2],few:2,data:[0,1,3],visit:2,three:[0,3],custom:0,avail:[0,3],start:3,again:2,busi:[0,3],includ:3,arg1:0,other:[0,2,3],instanc:0,instal:[1,3],challeng:[0,2,3],too:[0,2],"function":0,chapter:3,assign:2,option:[0,2],filter:[2,3],manager_nam:0,python:3,handler:0,similarli:2,protect:[0,1,3],specifi:[0,3],argument:0,provid:2,link:2,indic:[1,2],enqueu:[0,1],rel_field:0,max_length:0,inlin:0,"true":0,former:0,those:[0,2],sender:0,reset:2,admin:[0,1,2,3],none:0,bookadmin:0,my_inst:0,whenev:0,whether:2,wish:0,monitor_entri:0,moder:[0,1,2,3],monitor_nam:0,displai:[2,3],exampl:0,project:3,defin:0,invok:0,kwarg:0,can:[0,1,2,3],abov:[0,2],foreignkei:0,your_model:0,more:[0,2],def:0,connect:0,note:[0,3],sai:2,featur:[1,3],want:[0,3],creat:[0,2,3],look:2,process:3,certain:0,dure:[0,3],registr:[0,1,3],readm:3,them:2,changelist:[2,3],correspond:[2,3],handl:0,wai:3,shell:0,exist:[2,3],inherit:0,have:[0,3],tabl:[1,2],need:[2,3],seem:3,foreign:0,check:[0,2],everywher:3,alwai:0,develop:[0,1,3],built:0,perform:[0,2,3],otherwis:0,self:1,tip:0,detail:0,same:3,write:0,how:[0,1,2],book:[0,2],build:0,which:[0,3],auto:3,instead:0,you:[0,2,3],document:3,prepar:0,enabl:0,protected_field:0,relat:[0,1,3],http:3,thi:[0,2,3],get_current_us:0,status_nam:0,clone:3,who:[1,2],my_model:0,statu:[0,2,3],superus:2,action:[2,3],user:[0,1,2,3],applic:0,share:0,along:[0,3],supplementinlin:0,associ:[0,3],"class":[0,1],directori:3,repo:3,bitbucket:3,appropri:[2,3],base_manag:0,ani:[2,3],entri:2,mymodel:0,request:0,can_delete_approv:0,object:[0,1,2,3],actviti:3,post_moder:0,itself:[2,3],client:3,runtim:0,allow:0,choos:[2,3],model:[0,1,2,3],usual:0,make:[0,2],latest:3},objtypes:{},titles:["How to use (for developers)","Django-monitor self-help","How to use (for admin-users)","Introduction to Django-monitor"],objnames:{},filenames:["dev_howto","index","admin_howto","intro"]})
+Search.setIndex({objects:{},terms:{all:[0,2,3],code:[0,1],identifi:2,help:[0,1,2],just:[0,3],show:2,when:[0,3],yourmodeladmin:0,approv:[0,2,3],supplement:0,through:2,particualr:2,permiss:[2,3],skip:3,follow:[0,2],still:0,pointer:2,find:2,row:2,current:[0,2,3],onli:0,specif:3,monitor:[0,1,2,3],field:[0,3],field2:0,copi:3,field1:0,activ:[0,2],figur:2,shortcut:2,should:0,add:[2,3],pend:[0,2,3],about:[0,1,3],under:2,set:[0,3],must:2,might:0,app:[2,3],is_challeng:0,applic:0,non:2,sourc:3,rememb:0,thei:[0,2],get:[0,2,3],read:[0,3],prefer:0,watch:0,regularli:2,know:[0,2],got:3,press:[2,3],now:2,requir:[0,2,3],introduct:[1,3],well:[2,3],term:3,verifi:[0,2],name:[0,2,3],organ:0,hook:[0,1],signal:0,possibl:0,list:[0,2],method:0,separ:0,whether:2,either:0,each:[0,2,3],found:2,get_monitor_entri:0,where:[1,2],page:[1,2,3],mean:3,pleas:0,prevent:[0,3],right:2,nice:2,regist:0,arg1:0,creation:[0,1],some:[0,2,3],is_approv:0,see:[0,2],connect:0,pass:0,download:3,home:2,click:2,special:[0,1,2],out:2,index:1,what:[0,1,2],appear:2,lead:2,section:[0,2],below:[0,2],your:[0,2,3],content:1,delet:[0,3],written:0,version:3,leav:0,select:[2,3],django:[0,1,2,3],"import":0,paramet:0,"public":0,modeladmin:0,refer:[0,2],signatur:0,particular:[0,2,3],full:0,deriv:0,kei:0,whose:0,post:[0,1],my_model:0,filter:[2,3],usag:0,given:2,here:[0,2,3],like:2,how:[0,1,2],job:3,base:2,let:0,your_model:0,put:0,path:3,gatekeep:3,becom:3,modifi:0,valu:[0,3],box:2,both:[0,2],search:1,is_pend:0,column:2,someth:0,after:[0,2],manag:[0,2,3],queue:[0,2],related_nam:0,place:3,monitorentri:0,fals:0,charfield:0,chang:[0,2,3],handler_func:0,supplementinlin:0,origin:[0,3],readonly_field:0,own:3,point:2,onc:[0,2],modul:1,within:[2,3],reset_to_pend:0,number:2,automat:3,two:0,distinguish:3,alreadi:3,done:0,org:3,instal:[1,3],installed_app:3,assum:0,along:[0,3],middlewar:0,differ:[0,3],rajeesh:3,from:[0,1,2,3],describ:[0,2],would:[0,2],few:2,data:[0,1,3],visit:2,three:[0,3],custom:0,avail:[0,3],start:3,again:2,busi:[0,3],interfac:2,includ:3,replac:0,changelist:[2,3],challeng:[0,2,3],too:[0,2],"function":0,chapter:3,shell:0,option:[0,2],manager_nam:0,python:3,handler:0,similarli:2,protect:[0,1,3],specifi:[0,3],argument:0,provid:2,link:2,enqueu:[0,1],rel_field:0,max_length:0,inlin:0,"true":0,former:0,those:[0,2],sender:0,reset:2,admin:[0,1,2,3],none:0,bookadmin:0,my_inst:0,whenev:0,"default":[0,2],assign:2,monitor_entri:0,moder:[0,1,2,3],monitor_nam:0,displai:[2,3],exampl:[0,2],project:3,defin:0,invok:0,itself:[2,3],can:[0,1,2,3],abov:0,foreignkei:0,otherwis:0,other:[0,2,3],def:0,note:[0,2,3],featur:[1,3],have:[0,2,3],creat:[0,2,3],process:[2,3],certain:0,dure:[0,3],registr:[0,1,3],readm:3,them:2,indic:[1,2],correspond:3,"case":0,wai:3,kwarg:0,summar:2,inherit:0,want:[0,3],tabl:[1,2],testapp:2,exist:[2,3],foreign:0,seem:3,integr:3,everywher:3,alwai:0,develop:[0,1,3],built:0,author:2,perform:[0,2,3],self:1,tip:0,detail:[0,2],same:3,check:[0,2],write:0,also:[2,3],need:[2,3],instanc:0,build:0,which:[0,3],auto:3,instead:0,you:[0,2,3],document:3,prepar:0,enabl:0,protected_field:0,relat:[0,1,3],http:3,thi:[0,2,3],book:[0,2],get_current_us:0,status_nam:0,clone:3,who:[1,2],correct:2,statu:[0,2,3],superus:2,monitoradmin:0,action:[2,3],user:[0,1,2,3],handl:0,share:0,mai:[0,2,3],associ:[0,3],"class":[0,1],directori:3,repo:3,bitbucket:3,appropri:[2,3],base_manag:0,ani:[2,3],wish:0,entri:2,mymodel:0,request:0,can_delete_approv:0,object:[0,1,2,3],actviti:3,post_moder:0,more:[0,2],client:3,runtim:0,allow:0,choos:[2,3],model:[0,1,2,3],usual:0,make:[0,2],latest:3},objtypes:{},titles:["How to use (for developers)","Django-monitor self-help","How to use (for admin-users)","Introduction to Django-monitor"],objnames:{},filenames:["dev_howto","index","admin_howto","intro"]})

File docs/source/_static/custom_changelist.jpg

Removed
Old image

File docs/source/_static/moderation_actions.jpg

Added
New image

File docs/source/_static/moderation_changelink.jpg

Added
New image

File docs/source/_static/moderation_filter.jpg

Added
New image

File docs/source/_static/moderation_queue.jpg

Added
New image

File docs/source/_static/moderation_status_column.jpg

Added
New image

File docs/source/admin_howto.rst

View file
 How to use (for admin-users)
 =============================
 
-All moderation activities can be performed from within the admin changelist
-itself. The changelist view of a moderated model will look like that in the
-screen-shot below :
-
-.. image:: _static/custom_changelist.jpg
-   :scale: 70
-   :alt: Change-list
+All moderation activities can be performed from within the admin interface
+itself. Following sections describe the process in detail. The figures are
+based on an example app, ``TestApp`` with models like ``Author`` and ``Book``.
 
 Who can moderate
 ==================
 
-Django-monitor creates a moderate permission for each moderated model. Only
-those users with required permission can moderate any object of a particular
-model. The superuser must assign those permissions to the appropriate users
-as they would do with other commonly found permissions.
+Django-monitor creates a moderate permission for each moderated model.
+To moderate any object of a model, user need to have permission for that
+particular model. The superuser must assign those permissions to the
+appropriate users as they would do with other permissions.
 
 What to moderate & from where
 ===============================
 there. For moderated models, we add one more column, ``status`` to the right of
 each row. That column, as its name indicates, displays the current moderation
 status of each object you see in the list. This helps you to identify the
-pending as well as challenged objects. Also, you can filter the objects by their
-``moderation status`` using the filter options provided in the box to the right
-of change-list. Refer to the screen-shot given above.
+pending as well as challenged objects. See the figure:
+
+.. image:: _static/moderation_status_column.jpg
+   :alt: Status column
+
+Also, you can filter the objects by ``moderation status`` using the options
+provided in the box to the right of change-list. Refer to the figure below:
+
+.. image:: _static/moderation_filter.jpg
+   :alt: Filter
 
 You need not regularly visit change-lists of all models to know whether there
 are any objects to be moderated. ``Moderation Queue`` is the shortcut for this.
-It will summarize the moderation status for all models in one page. Click on
-the ``Moderation Queue`` change-link under the ``Monitor`` app in your admin
-home page. You can see the number of pending and challenged objects for each
-moderated model arranged in a nice table in the resulting page. Clicking on
-each number will lead you to the corresponding change-list filtered by the
-respective status. eg, if you clicked on the number of pending objects of the
-model, say, `Book`, the change-list showing all pending book objects will be
-loaded.
+It will summarize the moderation status for all models in one page. In your
+admin home page there is a ``Moderation Queue`` change-link under ``Monitor``
+app. See the figure:
+
+.. image:: _static/moderation_changelink.jpg
+   :alt: Moderation Queue change-link
+
+Clicking on it will lead you to a moderation queue page from where you can see
+a nice table listing out the number of pending and challenged objects for each
+moderated model. An example figure is given below:
+
+.. image:: _static/moderation_queue.jpg
+   :scale: 70
+   :alt: Moderation Queue page
+
+Note that the pointer points to the number `2` in the figure. This number
+indicates that there are 2 pending ``Author`` objects now. Click on that number
+and you will be lead to the ``Author`` change-list where you can see both of the
+pending objects. Similarly, you can find pending/challenged objects of any model
+from here.
 
 How to moderate
 =================
 
 Moderation is performed through 3 special change-list actions. They are,
 ``Approve selected``, ``Challenge selected`` and ``Reset selected to pending``.
+The figure below shows the actions found in ``Author`` changelist:
+
+.. image:: _static/moderation_actions.jpg
+   :alt: Moderation actions
+
 If the manager selects few objects, choose the action ``Approve selected`` and
-press ``Go``, those objects will get approved. Similarly, one can challenge some
+press ``Go``, those objects will get approved. Similarly, one can challenge 
 objects too. Once some objects get challenged, the non-managers may check them
 again and make required corrections. After that, they can reset the status to
 ``In pending`` using the action, ``Reset selected to pending`` so that their

File monitor/util.py

View file
     # Create corresponding monitor entry
     if kwargs.get('created', None):
         MonitorEntry.objects.create(
-            status = status, content_object = instance,
+            status = status, status_by = user,
+            content_object = instance,
             timestamp = datetime.now()
         )