Add a @webapi_docs decorator to store docs on the function.

 






 

 


  Review Request #14046
  —
  Created July 17, 2024 and updated  — Latest diff uploaded 

 


















 

  

   Information

  





 
 

  david
 









 
 

  Djblets
 









 
 

  release-6.x
 









 
 

  
 









 
 

  
 






 




 

  

   Reviewers

  





 
 

  djblets
 









 
 

  
 






 








 





  


 
 

  
This change adds a new decorator for us to use for attaching

public-facing documentation to HTTP methods, rather than putting it into

the docstring. This will let us have internal codebase docs in the docstring

instead, which is much more appropriate.

 








  


 
 

  
Used along with a change to our webapidocs Sphinx extension to pull this

data out.

 







 









 





  








 




 







   

    
    
Changes between revision 5 and 6



    

 

 

 

 
orig
1
2
3
4
5
6

 



    


    

      
Commits

      

 

 

  
   
  
  Summary
  ID
  Author
 



 
  
 
 
  
   
    

     Add a @webapi_docs decorator to store docs on the function.
     
This change adds a new decorator for us to use for attaching
public-facing documentation to HTTP methods, rather than putting it into
the docstring. This will let us have internal codebase docs in the docstring
instead, which is much more appropriate.

Testing Done:
Used along with a change to our webapidocs Sphinx extension to pull this
data out.

    

   
  		
  5fbccfd8d8802402f4f2a4a6ecae1dfa444f74b7
  David Trowbridge
 


 
  
 
 
  
   
    

     Add a @webapi_docs decorator to store docs on the function.
     
This change adds a new decorator for us to use for attaching
public-facing documentation to HTTP methods, rather than putting it into
the docstring. This will let us have internal codebase docs in the docstring
instead, which is much more appropriate.

Testing Done:
Used along with a change to our webapidocs Sphinx extension to pull this
data out.

    

   
  		
  508cc109ab61c2198d80f6f3e225d2998ae4b37e
  David Trowbridge
 




    


    
    

   

  

 









 

  

   
    

     
      
      djblets/webapi/decorators.py
     
    

   
  

 










     

    

   

  

  

   
   Loading...