Add a document covering Django Evolution's versioning policy.

 






 

 


  Review Request #11243
  —
  Created Oct. 24, 2020 and submitted 

 




















 

  

   Information

  





 
 

  chipx86
 









 
 

  Django Evolution
 









 
 

  master
 









 
 

  
 









 
 

  
 






 




 

  

   Reviewers

  





 
 

  django-evolution
 









 
 

  
 






 








 





  


 
 

  
As of 2.0, Django Evolution uses semantic versioning. Prior releases

didn't have any versioning policy, so it's not obvious, and as such it's

booa  easy to avoid thinking about proper deprecation and upgrade paths.

What parts of the project would impact the version also wasn't defined.


This change adds a Version Policy document that specifies the policy,

and when major/minor/micro versions will be updated. It also organizes

the codebase into Public API vs. Private API categories so it's clear

what changes will require version bumps.

 








  


 
 

  
Built the docs and read through it. Checked for errors.

 







 









 





  

 


 
 

  



 

  
   


    Summary
    ID

   

  
  

   


    

     

      Add a document covering Django Evolution's versioning policy.
      
As of 2.0, Django Evolution uses semantic versioning. Prior releases
didn't have any versioning policy, so it's not obvious, and as such it's
booa  easy to avoid thinking about proper deprecation and upgrade paths.
What parts of the project would impact the version also wasn't defined.

This change adds a Version Policy document that specifies the policy,
and when major/minor/micro versions will be updated. It also organizes
the codebase into Public API vs. Private API categories so it's clear
what changes will require version bumps.

     


    		
    bd6f302558b0ff8dd459ad32b9d4ac957afc29f0

   



  
 




 













 









 






  

 



















 




 




 














 





 

  

   




david




   

   







  

 



 

  


   

   

    
 
david


    
   


  

  

  



    




  1. 
 
    
  
    
   
    Ship It!
    
  
    
 
    

 
    
  


    
 
    
 
      

  

 
    


    

 
    

    2. 















  2. 
 
    
  
    
   
    
  
    
 
    

 
    
  


    
 
    
 
      

  

 
    


    

 
    

    3. 




  

 
















 



 

  

   




chipx86




   

   

  

 



 

  


   

   

    
 Review request changed

    
   


  

  

  







  

   

    Status:
   

   


    Completed

   

  




  

   

    Change Summary:
   

   

    
Pushed to master (1948b73)