Git repository under maintenance

[Jennifer Hodgdon]

Hello User Guide maintainers!

Short version of this message: Please no User Guide commits today. You'll need to re-clone tomorrow. I'll post an update when it's OK to clone/commit.

Longer version of this message:

A week or two ago, our Chinese translation manager "jungle" created an issue asking for the size of the Git repository for the User Guide to be reduced. The repo is very large, and when you initially "clone" it, it takes quite a while to download all the files/history, especially if you are on a slower Internet connection. The Drupal Infrastructure team has also mentioned to me that the repo is bigger than anything else in the entire Drupal project, so they're anxious also to have it be smaller. Here's the issue:

https://www.drupal.org/project/user_guide/issues/3074020

So, today Neil Drumm and I are working on reducing the repository size, by removing the built ebooks from the repo. Instead of storing them in the repo, I've created a page where they can be downloaded:

https://www.drupal.org/docs/8/understanding-drupal-8/user-guide-e-book-downloads

As part of the process of reducing the size, I've created 6 new branches in the repo without the ebooks. Later today, Neil is going to do some magic to attach the existing releases and tags to the new branches, and we'll get rid of the old branches so that the ebooks will vanish without a trace of history.

This means that today, the Git repo is in a bit of an in-between state, and it would probably be best not to make any commits to it. Also, after we're done, you'll need to re-clone. I'll send you an update as a reply to this message, when it's ready, with instructions.

Sorry for the inconvenience!

   --Jennifer

[Jennifer Hodgdon]

The Git repository maintenance is done! You will need to re-clone your local copy of the User Guide git repository.

To reduce the size of what you are downloading, you can use the --depth parameter to git clone, such as:

 git clone --branch 8.x-7.x --depth 5 g...@git.drupal.org:project/user_guide.git 

That will only grab the latest 5 commits of history -- so you wouldn't be able to look at the entire history of the project, but you'll have the latest files and the last few changes. If you do a clone without the depth, you'll be downloading 1.1 GB of data; with the depth set to 5, it is only 44 MB, which goes much faster.

If you have time, please take a look over the next few days and make sure your own latest changes are there, either in your newly-cloned local copy, or at 

https://git.drupalcode.org/project/user_guide

The old branches are still there (they have a "-old" suffix), so if we've lost something, we can still recover. We'll be deleting the old branches sometime soon.

Thanks for your patience, and happy translating!

Regards,

   Jennifer