Optimization of Git repository, too much time, data and bandwidth needed

[pylapp]

Context

@fsuc reported a lot of time was consumed during the download of its projects dependencies, specially with OUDS.
Swift Package Manager takes more than 10 minutes on CI/CD to download through proxys the OUDS Swift Package.

Indeed, if we clone the whole repository, we reach up to 1 GB of data, even if we use BFG to get rid of the design system toolbox app and put it in its repository (#187)

However if we download only the default branch, we download less content.

We can suppose the issue here is about the documentation Git branch gh-pages which contains hundred and hundreds of files.

Solutions to improve developer experience and reduce download time:

1. Xcode OUDS iOS through XCFramework referenced in another repo
2. Create a repos dedicated to the documentation, move the web site in that repo, and use BFG to wipe the branch
3. Use Git LFS

However:

1. A bit sad to provide an XCFramework for a full open source lib the IDE can compile
2. Better solution
3. Too much related to the GitHub Orange-OpenSource organisation without Git LFS disabled because of budget issues 💸

Workarounds

Tip

Change the Git configuration in increase limits, sizes and memory.

Tip

Reset the gh-pages branch to keep only one commit
(action done on 2026/07/24)

Definition of Done

• Create dedicated repository for documentation
• Refer to it in the README of this project
• Update the script to update the documentation
• Configure the new repository to have automatic deployments like today
• Use BFG to wipe the gh-pages branch

Screenshots

Single branch clone

Naive clone (default)

[pylapp]

Note

My own Git configuration (xxxxxx is fake data)

cat ~/.gitconfig
[user]
	email = pierreyves.lapersonne@orange.com
	name = Pierre-Yves Lapersonne
	signingkey = xxxxxx
[commit]
	gpgsign = true
[tag]
	gpgsign = true
[gpg]
	program = gpg
[core]
	packedGitLimit = 512m
	packedGitWindowSize = 512m
[pack]
	deltaCacheSize = 2047m
	packSizeLimit = 2047m
	windowMemory = 2047m%

[pylapp]

Note

@fsuc Git confguration

[user]
	name = François Suc
	email = francois.suc@orange.com
[filter "lfs"]
	clean = git-lfs clean -- %f
	smudge = git-lfs smudge -- %f
	process = git-lfs filter-process
	required = true
[alias]
  # Usage: git signoff-rebase [base-commit]
  signoff-rebase = "!GIT_SEQUENCE_EDITOR='sed -i -re s/^pick/e/' sh -c 'git rebase -i $1 && while git rebase --continue; do git commit --amend --signoff --no-edit; done' -"

[pylapp]

Note

Made a test with delete gh-pages branch: less data to download