CHANGELOG — révision scientifique complète (editorial board, 2026-10-17)
Papier : UQO WP 2 — Decoding Real Estate Descriptions (v1.1, mai 2026 → v1.2, octobre 2026).
État de départ figé : tag git pre-revision-20261017, PDF docs/main_pre-revision-20261017.pdf (53 p., 86 réf.).
Rapport de l'editorial board : docs/REVIEW-REPORT.md. Les audits antérieurs (restructuration du 2026-08-05) restent dans
docs/AUDIT.md, docs/CHANGES.md, docs/PAPER_REVIEW.md, docs/UPGRADE_REPORT.md.
Règle suivie : aucun nombre du texte n'a changé sans un résultat recalculé par un script versionné ; les chiffres de la v1.1 (modèles A–E, tables 2–8, figures 1–11) sont reproduits à l'identique et conservés comme « baseline ».
1. Réanalyses exécutées (toutes locales, < 1 min hors téléchargement des modèles)
| Script | Durée | Sorties | Contenu |
|---|---|---|---|
scripts/07_revision_extensions.py (nouveau) + src/extensions.py (nouveau) |
25 s (encodage multilingue des 17 087 textes : 15 s) | results/revision_language.csv, revision_language_by_dimension.csv, revision_specifications.csv, revision_spec_summary.csv, revision_block_tests.csv, revision_oos.csv, revision_reference_sensitivity{,_summary}.csv, revision_multilingual.csv ; cache data/processed/embeddings_multilingual.npy, revision_fields.csv |
(a) détection de la langue (stop-words FR/EN, règle 1,5) ; (b) 14 spécifications étendues : indicatrices de langue, EF RTA (415) et municipalité (1 061), erreurs groupées par RTA, taille de terrain convertie en m², sous-échantillon avec superficie habitable (6 228), sous-échantillons FR / EN, encodeur multilingue ; (c) tests de bloc par domaine ; (d) validation croisée 5 plis aléatoires et 5 plis groupés par RTA (R² OOS, RMSE, MdAPE) ; (e) sensibilité au libellé des références (3 perturbations) ; (f) ré-encodage avec paraphrase-multilingual-MiniLM-L12-v2 |
scripts/08_revision_tables.py (nouveau) |
3 s | paper/tables/tab_language.tex, tab_spec_summary.tex, tab_extended_specs.tex, tab_block_tests.tex, tab_oos.tex, tab_reference_sensitivity.tex ; figures/fig12_specification_stability.{pdf,png} |
tables et figure générées (jamais tapées) |
scripts/06_tables.py (modifié) |
1 s | paper/tables/tab_descriptive.tex |
étiquette « Lot size (sq. ft.) » → « Lot size (raw field, mixed units) » + note sur les unités ; chiffres inchangés |
Modèles téléchargés (HuggingFace, non versionnés) : all-MiniLM-L6-v2 (~90 Mo, nécessaire à la sensibilité des références) et
paraphrase-multilingual-MiniLM-L12-v2 (~470 Mo). Les embeddings baseline étaient en cache (embeddings_maisons.npy) ; les
embeddings multilingues sont mis en cache à leur tour.
2. Corrections majeures (où / avant / après / pourquoi / preuve)
| # | Où | Avant (v1.1) | Après (v1.2) | Pourquoi / preuve |
|---|---|---|---|---|
| 1 | Data §4.3, Intro, Résumé | « descriptions predominantly in French with occasional English phrases » | 57,6 % FR, 39,7 % EN, 2,7 % mixte ; prix médian EN 749 900 $ vs FR 499 900 $ | classification stop-words (revision_language.csv) ; vérifiée sur exemples |
| 2 | Data §4.4, Results §5.5–5.6 | corrélations bivariées négatives et corrélations inter-références « driven primarily by description length » | cause principale = langue : η² = 0,862 de la similarité moyenne, corr(PC1, anglais) = −0,82 vs corr(PC1, longueur) = 0,20 | revision_language.csv ; calcul PC1 |
| 3 | Résultats, Résumé, Intro | gain sémantique = ΔR² 0,047 (D vs B), « 9.3 % of explained variance » présenté sans réserve | ΔR² 0,017 avec indicatrices de langue ; 0,020 avec EF RTA ; 0,013 avec terrain m² ; 0,029 FR seul ; 0,024 EN seul ; multilingue 0,057/0,038/0,039/0,028 | revision_spec_summary.csv (Table « spec_summary ») |
| 4 | Discussion (Motivated Seller −8,5 % vs Levitt–Syverson 3,7 %) | discount d'urgence robuste, comparé à la littérature | −2,9 % non significatif avec la langue ; −4,0 %* intra-RTA ; 0,4 % avec l'encodeur multilingue → comparaison retirée, dimension classée non robuste | revision_specifications.csv ; écart FR/EN de similarité le plus grand (0,385 vs 0,076) |
| 5 | Discussion (New Construction) | « supported by the quantile regression results, which show a diminished negative effect at higher quantiles » | FAUX : coefficients −0,068 / −0,079 / −0,142 (τ = 0,25/0,50/0,75) → plus négatif en haut ; énoncé retiré ; signe positif (+7,2 %) avec l'encodeur multilingue | results/robustness_results.csv (déjà présent, non lu correctement en v1.1) |
| 6 | Results §5.4 | signes contre-intuitifs (Entry-Level +10,4 %, Premium Location −6,1 %, Energy Efficient −7,8 %, Bright & Spacious −8,9 %) non discutés | discutés comme signature de la colinéarité (Entry-Level/Motivated Seller r = 0,97) ; inversions documentées avec l'autre encodeur | Table 5 + tab_extended_specs |
| 7 | Intro, Results, Discussion | « semantic features … comparable to the gains from adding neighborhood controls (Sirmans et al. 2006 : 3–8 pp) » | retiré : affirmation non vérifiable dans Sirmans et al. (2006) ; nos propres EF RTA ajoutent ~15 pp vs 2 pp pour le texte | aucune statistique de ce type dans la méta-analyse citée |
| 8 | Results §5.1 | R² de 45 % « consistent with the typical range … (Sirmans et al. 2005) » | reformulé : benchmark volontairement pauvre, sans localisation ; les EF RTA seules portent le R² à ~0,65 | Sirmans et al. (2005) ne rapportent pas de R² typique |
| 9 | Data, Table 2 | « Lot size (sq. ft.) » | « Lot size (raw field, mixed units) » : 61 % m², 32 % pi², 2 % acres/ha, 4 % manquant ; variable conservée en baseline, remplacée par log(m²) + indicatrice en §7 | parsing de Land.SizeTotal ; hors échantillon le champ brut donne R² = −1,04 |
| 10 | Methodology | interprétation « par écart-type » affirmée sans formule ; test F sans df | Éq. (impact) 100(e^γ−1) par σ_s, équivalent γ/σ par unité de cosinus ; F(21, 17 059) ; Wald robustes/groupés | — |
| 11 | Methodology §3.7, Identification | trois canaux ; pas de mention de la séquence prix → texte | ajout : texte rédigé après fixation du prix par le même agent → prix et texte conjointement déterminés ; prix affichés = comportement vendeur/courtier | — |
| 12 | Methodology §3.4 | « dimensional specificity » revendiquée | reconnue imparfaite : chevauchements Land & Nature/Waterfront, Modern/New Construction/Energy Efficient, Premium Location/Family-Friendly (Annexe A) | lecture des textes de référence |
| 13 | Robustness §6.3 | Modern/Contemporary « remarkably stable across quantiles » | « larger at both tails than at the median » (0,148/0,121/0,155), cohérent avec la Table 6 | robustness_results.csv |
| 14 | Robustness §6.5 | bootstrap présenté comme validation complète de l'inférence | ajout : bootstrap par paires ignore la dépendance intra-RTA ; clustering en §7 (SE +50 % en moyenne, 22–107 %) | revision_specifications.csv |
| 15 | Résumé | « I show » / corps en « we » ; chiffres sans qualification | résumé réécrit (« we »), 3 qualifications (langue, sensibilité, associations) | — |
| 16 | Orthographe | mélange américain/britannique (neighborhood/neighbourhood, standardized…) | britannique/canadien partout dans les sections (clés de citation et .bib intacts) | — |
| 17 | Page titre | \WPdate May 2026, \WPversion 1.1 |
October 2026, 1.2 ; mots-clés : + « text as data », « listing descriptions » (7) | protocole |
Sections réécrites intégralement : introduction, méthodologie, données, résultats, robustesse, discussion, conclusion ;
section 7 « Extended Specifications and Validation » ajoutée (paper/sections/extended.tex) ; littérature enrichie
(voir §3) ; annexe inchangée (tables A1–A2) ; tables manuelles tab_robustness_summary (10 lignes ajoutées) et
tab_text_comparison (ligne multilingue +0,069) mises à jour.
3. Références
- Avant : 86 entrées (toutes vérifiées lors de l'audit du 2026-08-05 via OpenAlex). Après : 94 entrées.
- Vérifications 2026-10-17 (Crossref
api.crossref.org/works?query.bibliographic=puis résolution DOIdoi.orgen content negotiation) des références clés citées dans le mandat : Nowak & Smith 2017 JAE 32(4) 896–918 (10.1002/jae.2550) ✓ ; Shen & Ross 2021 JUE 121, 103299 ✓ ; Goodwin–Waller–Weeks 2014 JHR 23(2) ✓ et 2018 JHR 27(2) ✓ ; Pryce & Oates 2008 Housing Studies 23(2) ✓ ; Gentzkow–Kelly–Taddy 2019 JEL 57(3) ✓ ; Reimers & Gurevych 2019 ✓ ; Levitt & Syverson 2008 REStat 90(4) ✓ ; Zietz–Zietz–Sirmans 2007 JREFE 37(4) ✓ ; Ethayarajh 2019 ✓ ; Loughran–McDonald 2011/2016 (déjà avec DOI). - Ajoutées (8, toutes avec DOI résolu) :
nowak2021dictionaries(Nowak, Price & Smith, JREFE 62(1), 10.1007/s11146-019-09740-w) ;reimers2020multilingual(EMNLP 2020, 10.18653/v1/2020.emnlp-main.365) ;cameron2015practitioner(JHR 50(2), 10.3368/jhr.50.2.317) ;abadie2023when(QJE 138(1), 10.1093/qje/qjac038) ;roberts2017cross(Ecography 40(8), 10.1111/ecog.02881) ;hastie2009elements(Springer, 10.1007/978-0-387-84858-7) ;garcia2023colour(JFE 147(3), 10.1016/j.jfineco.2022.11.006) ;kelly2021measuring(AER: Insights 3(3), 10.1257/aeri.20190499). - Retirées : aucune. « Hausman–Taddy » (demandé à vérifier) : aucune publication conjointe trouvée sur Crossref → non ajoutée. « Garcia et al. » interprété comme García, Hu & Rohrer (2023), vérifié et ajouté.
- Citation de Sirmans et al. (2005, 2006) à l'appui de chiffres qu'ils ne contiennent pas : citations conservées pour ce qu'elles montrent (composition des modèles, méta-analyse), affirmations chiffrées retirées (corrections 7–8).
4. Éléments non modifiés / non exécutés
- Prix de transaction, panel temporel, variation intra-propriété, expériences A/B : données absentes → décrits comme non exécutés.
- Encodeur français dédié (CamemBERT/FlauBERT, non distillés pour la similarité) et références orthogonalisées : non exécutés (hors périmètre < 30 min ; recommandé).
- Superficie habitable disponible pour 36 % seulement : analyse sur sous-échantillon, pas d'imputation.
- Tables 2–8 et figures 1–11 : régénérées à l'identique ; aucune valeur changée (hormis l'étiquette de la ligne « Lot size »).
data/raw/louka.db: toujours non versionné ; tableuserstoujours présente (recommandation de la purger maintenue).