rsnext/contributing/core
Benjamin Woodruff 792b8485fe
docs: Suggest a blobless clone instead of a shallow clone (#64693)
GitHub recommends blobless clones over shallow clones:
https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/

> For these reasons we do not recommend shallow clones except for builds
that delete the repository immediately afterwards. Fetching from shallow
clones can cause more harm than good!

I've been using blobless clones for development for the last couple
weeks. The blobless clone has the benefit of including the full
repository history (for the cloned branch). Tools like `git blame` will
be slower as git fetches the related blobs on-demand.

Benchmarks (using all the flags in the docs):
- The blobless clone is faster on my machine, taking 11.1 seconds versus
13.1 seconds for the shallow clone.
- The blobless clone takes up 256M on disk, versus 244M for the shallow
clone. It's worse, but not by much.
2024-04-18 08:35:49 -07:00
..
adding-error-links.md refactor: split up CONTRIBUTING.md (#40515) 2022-09-16 14:54:58 -07:00
adding-features.md chore: improve repo templates (#46629) 2023-03-01 09:25:51 -08:00
building.md feat(turbopack): Experimental wasm build (#57906) 2023-11-02 21:00:54 +00:00
developing-using-local-app.md Makes codeblock language and filename extensions consistent (#51056) 2023-06-12 18:55:08 +00:00
developing.md docs: Suggest a blobless clone instead of a shallow clone (#64693) 2024-04-18 08:35:49 -07:00
testing.md docs: remove reference to createNextDescribe in favor of nextTestSetup (#62245) 2024-02-20 11:57:48 +01:00
vscode-debugger.md refactor: split up CONTRIBUTING.md (#40515) 2022-09-16 14:54:58 -07:00