diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000000000000000000000000000000000000..13f0c2957fae0662d252201447d940e33677dfe1
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+*~
+*.pyc
+__pycache__
+
+*.csv
diff --git a/README.md b/README.md
index edd23a09fac9d386d51f5b52423e4bc031e20250..7d010dace3150ace8e46b322045b454119f17bb2 100644
--- a/README.md
+++ b/README.md
@@ -13,3 +13,27 @@ Packaging informations :
 - https://packaging.python.org/en/latest/tutorials/packaging-projects/
 - https://choosealicense.com/
 
+## Troubleshooting
+
+If we have untracked data files in the package tree, flist refuses to build the
+package.
+
+```shell
+$ flit build
+Fetching list of valid trove classifiers                                                                                                                                                    I-flit.validate
+Untracked or deleted files in the source directory. Commit, undo or ignore these files in your VCS.
+```
+
+If we add a line to ignore, e.g. all csv files, in `.gitignore` we get a warning when we want to add one.
+
+```shell
+$ git add src/import-resources-example/data/WPP2022_TotalPopulationBySex.csv
+Les chemins suivants sont ignorés par un de vos fichiers .gitignore :
+src/import-resources-example/data/WPP2022_TotalPopulationBySex.csv
+astuce: Utilisez -f si vous voulez vraiment les ajouter.
+astuce: Éliminez ce message en lançant
+astuce: "git config advice.addIgnoredFile false"
+```
+
+As we can append the data files with `-f`, I will ignore the data file in `.gitignore`.
+