more info README

README.md

@@ -10,12 +10,12 @@ pinned: true
 license: apache-2.0
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Start the configuration
 
-Most of the variables to change for a default leaderboard are in src/env (replace the path for your leaderboard) and src/about.
+Most of the variables to change for a default leaderboard are in `src/env.py` (replace the path for your leaderboard) and `src/about.py` (for tasks).
 
-Results files should have the following format:
-```
+Results files should have the following format and be stored as json files:
+```json
 {
     "config": {
         "model_dtype": "torch.float16", # or torch.bfloat16 or 8bit or 4bit
@@ -37,3 +37,9 @@ Request files are created automatically by this tool.
 
 If you encounter problem on the space, don't hesitate to restart it to remove the create eval-queue, eval-queue-bk, eval-results and eval-results-bk created folder.
 
+# Code logic for more complex edits
+
+You'll find 
+- the main table' columns names and properties in `src/display/utils.py`
+- the logic to read all results and request files, then convert them in dataframe lines, in `src/leaderboard/read_evals.py`, and `src/populate.py`
+- teh logic to allow or filter submissions in `src/submission/submit.py` and `src/submission/check_validity.py`