diff options
| author | Alex <alex.corcoles@veecle.io> | 2025-09-12 15:58:10 +0200 |
|---|---|---|
| committer | alexpdp7 <alex@corcoles.net> | 2025-09-12 15:59:32 +0200 |
| commit | 63028e054d29c5ef938e69eebe387f1f2b6d5982 (patch) | |
| tree | 63dfbcd86c4b94ac34ef14bf1049e3eb968692a3 /programming | |
| parent | dd1cf5c98931645856092ae48578f8d6fa9f2dc1 (diff) | |
Apply Git learnings, update subrepo advice
Diffstat (limited to 'programming')
| -rw-r--r-- | programming/git/git_advice.md | 14 | ||||
| -rw-r--r-- | programming/python/project_setup.md | 4 |
2 files changed, 5 insertions, 13 deletions
diff --git a/programming/git/git_advice.md b/programming/git/git_advice.md index 2df2e07d..7dd19818 100644 --- a/programming/git/git_advice.md +++ b/programming/git/git_advice.md @@ -7,19 +7,11 @@ Configure your system so that `git commit` opens your preferred editor. With `git commit -v` you can see your commit diff while writing your commit message. This helps you review that your commit is correct and write a better commit message. -## Use a global gitignore +## Use gitignore properly -See <https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration.html#_core_excludesfile>. +See <https://git-scm.com/docs/gitignore>. -I recommend that the `.gitignore` in a Git repository should only include files that the "supported" procedures for working of your repository generate. -For example, `.gitignore` should exclude files generated by running or compiling the project. - -If your editor or operating system generates files in the repository, I suggest those are not excluded by the `.gitignore` in the repository, but on your personal global gitignore. - -This is more efficient: - -* You only have to add exclusions that you need once. -* The project `.gitignore` is smaller and requires less mental overhead to maintain. +Note that by default, Git defaults to `$XDG_CONFIG_HOME/git/ignore` or `$HOME/.config/git/ignore`. ## Use the modern Git commands (or teach them) diff --git a/programming/python/project_setup.md b/programming/python/project_setup.md index 493c65b7..1eb54307 100644 --- a/programming/python/project_setup.md +++ b/programming/python/project_setup.md @@ -65,7 +65,7 @@ Use Ruff to format and lint your code. ## Use a minimal gitignore file -Keep editor-specific ignores in a personal `excludesfile`. Do not include patterns in gitignore which do not match anything generated by documented and supported development procedures. +See <../git/git_advice.md#use-gitignore-properly>. ## Keep your code together @@ -73,7 +73,7 @@ All the code you modify as part of the project should be kept in a single reposi Use git submodules or similar mechanisms to refer to code you modify that must be kept external. -Use git subrepo to publish parts of the repository outside the main repository if needed. +Use [Josh](../git/combining_repos_with_josh_filter.md) to publish parts of the repository outside the main repository if needed. # Support multiple modern versions of Python |
