<div dir="ltr">Hi Blender Developers and Blender Documenters,<div><br></div><div>Over the years SVN, has caused several headaches from server database</div><div>corruptions to terrible download performance to poor branching support.</div><div><div>I believe it is time that we migrate from SVN to Git to some of our projects,</div><div>notably, the documentation project. The issue has been in the past that Git has</div><div>terrible support for binary files resulting in large download and repository sizes.</div><div>Over the years several hacks were made to make Git work with binary files but</div><div>their implementation was poor and those projects have since died.</div><div><br></div><div>There is however one project that made a proper implementation and over the years</div><div>has grown in both popularity and stability/reliability, this being Git Large File Support (Git + LFS).</div><div>I will not go into the details of how 

Git + LFS works but it is described well in the video [1].</div><div><br></div><div>Implementation on the client-side is easy, simply make sure Git LFS is installed.</div><div>Server-side implementation is a bit trickier, as there is no official implementation.</div><div>Many open-source implementations exist however are documented here: [2]</div><div><br></div><div>I have set up a test project on GitHub [3], <span style="color:rgb(0,0,0);font-family:"Segoe UI","Segoe UI Emoji","Segoe UI Symbol",Lato,"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:13px">if people want commit access for testing</span></div><div><span style="color:rgb(0,0,0);font-family:"Segoe UI","Segoe UI Emoji","Segoe UI Symbol",Lato,"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:13px">purpose let me know.</span></div><div><br></div><div>Converting the documentation project to Git + LFS will involve converting both the</div><div>main repository and the translations repository. Unflortiantly, translators will lose the</div><div>ability to checkout only there languages however once implementing Weblate [4]</div><div>translators will no longer directly interact with the repository.</div><div><br></div><div>The primary focus of this is to test how well 

Git + LFS will work for us and the community.</div><div>A goal in moving to Git + LFS is to make it easier to contribute to Blender,</div><div>a couple of weeks ago I had to help two already Blender contributors learn SVN over Git.</div><div>If it is a success for us and the community then efforts can be made into converting</div><div>other repositories as well. For example, the main Blender translation repository,</div><div>and Blender's pre-compiled libraries.</div><div><br></div><div>A useful article I found from a game production studio that also made the switch</div><div>is a very helpful and talks about why they made the switch along with the process they took.</div><div>I have linked the article below [5]. <br></div><div><br></div><div>1. <a href="https://youtu.be/uLR1RNqJ1Mw">https://youtu.be/uLR1RNqJ1Mw</a></div><div>2. <a href="https://github.com/git-lfs/git-lfs/wiki/Implementations">https://github.com/git-lfs/git-lfs/wiki/Implementations</a></div><div>3. <a href="https://github.com/Blendify/blender-manual">https://github.com/Blendify/blender-manual</a></div><div>4. <a href="https://developer.blender.org/T68588">https://developer.blender.org/T68588</a></div><div>5. <a href="https://labs.karmaninteractive.com/svn-to-git-its-about-time-ae4c468549be">https://labs.karmaninteractive.com/svn-to-git-its-about-time-ae4c468549be</a></div><div><br></div><div>Thanks for reading,</div><div> </div><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div dir="ltr"><span style="color:rgb(153,153,153)"><span style="color:rgb(0,0,0)">Aaron Carlisle</span><br></span><div><span style="color:rgb(153,153,153)"><br></span><div><span style="color:rgb(153,153,153)">Project administrator for the Blender 3D Documentation Project</span></div><div><span style="color:rgb(153,153,153)"><div dir="ltr" style="font-size:12.8px;color:rgb(34,34,34)"><div style="font-size:small"><span style="color:rgb(153,153,153)">Email: <a href="mailto:carlisle.b3d@gmail.com" style="color:rgb(17,85,204)" target="_blank">carlisle.b3d@gmail.com</a></span></div><br><div><br></div></div><div style="font-size:12.8px"></div></span></div></div></div></div></div></div></div>