• 
  
    
 
    
 
    

    



    
    
    
    
     
    




    
 
    

  
    



    
 

 

  

  

 

    


  
    





    
 
    



  

    
 
 
    
  
    Add documentation for UserConditionChoicesHook.
    
 
    

    



 
    
 
    

  Review Request #15275
  —
  Created Sept. 4, 2026 and updated 

 
    


    




    




    






 
    
  
    
   Information

  
    



    
 
 
    
  david
 
    

    





    
 
 
    
  Review Board
 
    

    





    
 
 
    
  release-9.x
 
    

    





    
 
 
    
  
 
    

    





    
 
 
    
  15239
 
    

    



 
    



 
    
  
    
   Reviewers

  
    



    
 
 
    
  reviewboard
 
    

    





    
 
 
    
  
 
    

    



 
    



    


    
 
    




  

    
 
 
    
  
    This adds a hook page for UserConditionChoicesHook, covering how acting-user
    
condition choices differ from review request choices, the need to cache
    
computed match values, and an example extension. The hook is also listed in
    
the extension hooks index.
    

    The hook docstring now links to the new page instead of explaining the
    
caching requirements inline, matching ReviewRequestConditionChoicesHook.
    
 
    

    





  

    
 
 
    
  
    Built documentation and checked the output.
    
 
    

    




 
    

    





    
 
    




  
    
 
 
    
  


    
 
    
  
   
    

    Summary
    ID

   
    
      
  

   
    

    

     
    
      Add documentation for UserConditionChoicesHook.
      
    This adds a hook page for UserConditionChoicesHook, covering how acting-user
condition choices differ from review request choices, the need to cache
computed match values, and an example extension. The hook is also listed in
the extension hooks index.

The hook docstring now links to the new page instead of explaining the
caching requirements inline, matching ReviewRequestConditionChoicesHook.
    
     
    

        		
    rrpqxnqotpkxmxwtxkotnnpnzsulpxyr

   
    


      
 
    

    
    
 
    

    






 





    
 
 
 
    
  
    
   
    
    
    
     
    
    
    
      
     
    • 
      
     
      • 
     
    • 
      
     
      • 
     
    • 
      
     
      • 
     
    • 
      
     
      • 
     
    • 
      
     
      • 
    
    
   
    
   
    
    
     
    
      Description
      From
      Last Updated
     
    
        
    



     
    
      
       
       
    We could ref to repository-bug-tracker here.
    
          		
      


maubin

  maubin
 

      
      
       
      
     
    



     
    
      
       
       
    Can we say just "such as a user's department." (related to my user roles comment below).
    
          		
      


maubin

  maubin
 

      
      
       
      
     
    



     
    
      
       
       
    Lets get rid of this example because its too similar to our actual User Roles. On that note we should …
    
          		
      


maubin

  maubin
 

      
      
       
      
     
    

        
   
    
  
    
 
    

    




 
    

    



  
    
 
    

    


    












    
 




 

    


 













    
 





 
    
  
    
   
    



maubin




   
    
   
    





    
  
    
 
    


 
    
  
    

   
    

   
    

    
    





  maubin
 


    
    
    
    
     


      


     
    
    
   
    


  
    
  
    
  
    


      




    1. 
 
      
  
      
   
      
  
      
 
      

 
      
  


      
 
      
 
        

  

 
      


      

 
      

      2. 

















    2. 
 
      
  
  
      
  
 
      
  
      
   
      
    
     
      
      
       docs/manual/extending/extensions/hooks/user-condition-choices-hook.rst
       


        (Diff revision 1)


       
      
     
      
          
    
     
       
      

     
       
      

          
   
      
  
      
 
      

   
      
    
    




      
 
      
  
  
  

  
  
   Show all issues
  
 
      

      



    
      We could ref to repository-bug-tracker here.
      
  
      
 
      

 
      
  


      
 
      
 
        

  




      1. 
 
 
        

 

 
        
  
        I don't have docs for a lot of the new stuff yet, but I'll make a note to add that once I do.
        
 
        

        2. 


 
      


      

 
      

      3. 






    3. 
 
      
  
  
      
  
 
      
  
      
   
      
    
     
      
      
       docs/manual/extending/extensions/hooks/user-condition-choices-hook.rst
       


        (Diff revision 1)


       
      
     
      
          
    
     
       
      

     
       
      

     
       
      

          
   
      
  
      
 
      

   
      
    
    




      
 
      
  
  
  

  
  
   Show all issues
  
 
      

      



    
      Can we say just "such as a user's department." (related to my user roles comment below).
      
  
      
 
      

 
      
  


      
 
      
 
        

  

 
      


      

 
      

      4. 






    4. 
 
      
  
  
      
  
 
      
  
      
   
      
    
     
      
      
       docs/manual/extending/extensions/hooks/user-condition-choices-hook.rst
       


        (Diff revision 1)


       
      
     
      
          
    
     
       
      

     
       
      

          
   
      
  
      
 
      

   
      
    
    




      
 
      
  
  
  

  
  
   Show all issues
  
 
      

      



    
      Lets get rid of this example because its too similar to our actual User Roles.
      

      On that note we should have a corresponding Power Pack change that adds a UserRoleChoice for matching the acting user's user role.
      
  
      
 
      

 
      
  


      
 
      
 
        

  




      1. 
 
 
        

 

 
        
  
        Yep, that's on my to-do list.
        
 
        

        2. 


 
      


      

 
      

      5. 




    5. 
 
      
  
      
   
      
  
      
 
      

 
      
  


      
 
      
 
        

  

 
      


      

 
      

      6. 


    

  
    
 
    

    












    
 



 
    
  
    
   
    



david




   
    
   
    
  
    
 
    


 
    
  
    

   
    

   
    

    
    
Review request changed
    
    
    
    
     


      


     
    
    
   
    


  
    
  
    
  
    




    









  
    
   
    
    Commits:
   
    
   
    
    
    



    
 
    
  
   
    

    

    Summary
    ID

   
    
      
  

   
    

    

    

     
    
      Add documentation for UserConditionChoicesHook.
      
    This adds a hook page for UserConditionChoicesHook, covering how acting-user
condition choices differ from review request choices, the need to cache
computed match values, and an example extension. The hook is also listed in
the extension hooks index.

The hook docstring now links to the new page instead of explaining the
caching requirements inline, matching ReviewRequestConditionChoicesHook.
    
     
    

        		
    rrpqxnqotpkxmxwtxkotnnpnzsulpxyr

   
    



   
    

    

    

     
    
      Add documentation for UserConditionChoicesHook.
      
    This adds a hook page for UserConditionChoicesHook, covering how acting-user
condition choices differ from review request choices, the need to cache
computed match values, and an example extension. The hook is also listed in
the extension hooks index.

The hook docstring now links to the new page instead of explaining the
caching requirements inline, matching ReviewRequestConditionChoicesHook.
    
     
    

        		
    rrpqxnqotpkxmxwtxkotnnpnzsulpxyr

   
    


      
 
    

    


    

   
    
  
    




  
    
   
    
    Diff:
   
    
   
    
    
     Revision 2 (+228 -12)
    Show changes
     
        docs/manual/extending/extensions/hooks/index.rst 
        docs/manual/extending/extensions/hooks/user-condition-choices-hook.rst 
        reviewboard/extensions/hooks/conditions.py 
     
    
   
    
  
    





    



    
 
    
  
    Checks run (2 succeeded)
    


  
    
 flake8
 passed.
 


    


  
    
 JSHint
 passed.
 


    


 
    









    




  
    
 
    

    












    
 





 
    
  
    
   
    



maubin




   
    
   
    





    
  
    
 
    


 
    
  
    

   
    

   
    

    
    





  maubin
 


    
    
    
    
     


      


     
    
    
   
    


  
    
  
    
  
    


      




    1. 
 
      
  
      
   
      Ship It!
      
  
      
 
      

 
      
  


      
 
      
 
        

  

 
      


      

 
      

      2. 















    2. 
 
      
  
      
   
      
  
      
 
      

 
      
  


      
 
      
 
        

  

 
      


      

 
      

      3.