SPB Git forge

spb/wp18_uqo

Public
6commits 1branches 0releases
5.4 MBsize
maindefault branch
yesterdaylast push
TeX 53.2% Python 46.6%
12.3 KB

# WP18 — Audit de style de la série UQO Working Papers (Phase 0)

Date : 2026-10-20. Sources inspectées localement : les 17 dépôts ~/Desktop/Recherche-UQO/{immobilier,finance}/*/paper/ (main.tex, sections/, appendix/, tables/, references.bib, main.pdf) et le gabarit ~/Desktop/Recherche-UQO/_modele-working-paper/, ainsi que HARMONISATION.md (standard du 2026-10-17) et REVISION-PROTOCOLE.md. Lecture détaillée : WP2 (decoding-real-estate- descriptions), WP5 (airbnb-rents-housing-pressure), WP8 (polymarket-arrow-debreu, seul WP avec environnements de théorèmes), WP10 (assessment-gap-quebec), WP16 (sales-comparison-validation). Les autres WP ont été inspectés par grep (préambule, métadonnées, flottants, bibliographie). Aucun fichier manquant : les 17 main.tex et 17 main.pdf sont présents (WP18 n'a pas encore de PDF).

# 1. Couverture et numéro

  • paper/sections/titlepage.tex = copie exacte du gabarit (identique dans WP18 : vérifié par diff implicite, même taille 1458 o). Logo uq_logo.jpg 3,5 cm ; « Université du Québec en Outaouais » / « Département des sciences administratives » en \footnotesize\textsc ; « Working Paper No.~\WPnumber » ; titre \LARGE\bfseries ; sous-titre \large\itshape si non vide ; auteur \large ; affiliation, courriel (\href{mailto:}), adresse ; date « Month YYYY » ; « Version x.y ». Page 2 : règle, Abstract, Keywords:, JEL Classification:, règle. \thispagestyle{empty} sur les deux pages.
  • Numéro : \WPnumber{18} (HARMONISATION §1 : un numéro = un papier ; 1–17 figés). Dépôt spbgit wp18_uqo.git.
  • Métadonnées obligatoires dans main.tex : \WPnumber, \WPtitle, \WPsubtitle, \WPdate, \WPversion, \WPabstract, \WPkeywords, \WPjel, \WPauthor, \WPaffiliation, \WPemail, \WPaddress. Valeurs observées sur les 17 WP : \WPdate{October 2026} (jamais \today), \WPversion = 1.1–2.1 (nombre seul), 5–8 mots-clés en minuscules sauf noms propres, séparés par des virgules ; JEL en codes séparés par des virgules.
  • Affiliation / courriel / adresse = macros du gabarit, à ne pas modifier : \WPaffiliation{Département des sciences administratives\\ Université du Québec en Outaouais}, \WPemail{simon-pierre.boucher@uqo.ca}, \WPaddress{Gatineau -- Pavillon Alexandre-Taché\\ 283, boulevard Alexandre-Taché\\ Gatineau, Québec, Canada J9A 1L8}. Auteur unique Simon-Pierre Boucher (WP17 est le seul multi-auteurs). Aucun WP ne comporte de remerciements ni de coauteur inventé ; WP18 n'en aura pas.

# 2. Typographie et préambule (commun aux 17 WP)

\documentclass[12pt,letterpaper]{article} ; inputenc utf8, fontenc T1, babel english ; geometry marges 1 in ; mathptmx (Times texte + maths) + microtype ; setspace \onehalfspacing ; amsmath, amssymb, amsthm ; booktabs, tabularx, multirow, threeparttable, siunitx ; graphicx, subcaption, float ; xcolor[dvipsnames] + hyperref colorlinks NavyBlue ; caption (small, labelfont bf, labelsep period, justified) ; fancyhdr (numéro de page centré, pas de filet) ; titlesec (\section = \large\bfseries « 1. », \subsection = \normalsize\bfseries, \subsubsection = \normalsize\itshape) ; appendix[toc,page] ; enumitem nosep. Le main.tex de WP18 est déjà la copie du gabarit : ne rien retirer, seulement ajouter les environnements de théorèmes (§6) et renseigner les métadonnées.

# 3. Résumé, mots-clés, JEL

Résumé de 150–220 mots sur la page 2, en un seul paragraphe, résultats réels seulement (REVISION-PROTOCOLE : pas de « novel », « comprehensive »…). Exemples de JEL de la série immobilier : R21, R31, R32, R51, R52, H22, H71, C21… WP18 proposera R21, R31, D31, D91, E31, E44, G51 (à confirmer une fois les résultats connus ; E21 possible pour l'épargne/richesse des ménages).

# 4. Structure des sections (observée)

Fichiers séparés dans paper/sections/ (noms simples : introduction.tex, literature.tex, data.tex, methodology.tex, results.tex, robustness.tex, discussion.tex (WP1, 2, 3, 9, 10, 17), conclusion.tex) ; WP5 et WP15 numérotent 01_introduction.tex… ; les deux conventions coexistent, la non-numérotée est celle du gabarit. Les titres de section sont en anglais : « Introduction », « Related literature » (WP10) / « Literature review », « Data and sample construction », « Methodology », « Results », « Robustness », « Discussion » (sous-sections « Mechanisms », « Policy implications », « Limitations »), « Conclusion ». WP8 (seul WP avec de la théorie) ajoute theoretical.tex (« Theoretical framework ») entre la revue et les données.

Adaptation WP18 (papier théorique, pas de section Données) — mêmes fichiers, renommés selon le plan du CLAUDE.md : introduction.tex, literature.tex (section 4 du plan : revue critique par mécanismes et lacunes), model.tex (environnement, timing, programmes, contraintes, marchés), equilibrium.tex (définition d'équilibre + propositions), numerical.tex (algorithme, calibration, vérification), baseline.tex (simulations de base, héritage, inégalité), inflation.tex (contrefactuels inflation / contrat hypothécaire), supply_policy.tex (élasticité de l'offre, politique, bien-être), robustness.tex (sensibilité, limites), conclusion.tex. Les fichiers data.tex/methodology.tex/results.tex du squelette seront remplacés (pas de section vide). Prose académique sobre, sans listes à puces dans le corps (REVISION-PROTOCOLE), équations numérotées et référencées (\eqref), \label{sec:…}, \label{eq:…}, \label{fig:…}, \label{tab:…}, \label{prop:…}.

# 5. Figures et tables

  • Figures : \begin{figure}[H] ou [htbp] (WP16 et WP10 : [H]), \centering, \includegraphics[width=\textwidth]{fN_slug.pdf} (fichiers PDF vectoriels dans paper/figures/, chemin résolu par \graphicspath ou copie ; WP16 nomme f1_…, f2_…), légende descriptive d'une à trois phrases après le graphique, \label{fig:…}. Aucune figure PNG dans le PDF ; les PNG servent d'aperçus (README). WP18 : results/figures/figNN_slug.{pdf,png} générés par src/figures.py, copiés dans paper/figures/.
  • Tables : \begin{table}[H], \centering, \caption{…} avant la table, \label{tab:…}, \small/\footnotesize, corps \input{tables/<nom>} généré par script (fragment tabular + booktabs : \toprule/\midrule/\bottomrule, pas de filets verticaux), notes en \begin{tablenotes}\footnotesize \item Note: … \end{tablenotes} (threeparttable). Les tables larges passent par \resizebox{\textwidth}{!}{\input{…}}. Jamais de table tapée à la main (REVISION-PROTOCOLE) : WP18 génère results/tables/*.tex via src/tables.py et les copie dans paper/tables/.
  • Nombres du texte : WP16 injecte ses chiffres par des macros générées (\input{tables/numbers} → \newcommand{\nSalesRaw}{456,950}), ce qui garantit « chaque nombre du papier correspond à un fichier de résultats ». WP18 reprend ce mécanisme : paper/tables/numbers.tex généré par src/tables.py.
  • Virgules protégées dans les titres : 140{,}931.

# 6. Environnements de théorèmes

Aucun des WP1–17 n'est théorique. Seul WP8 (polymarket-arrow-debreu) déclare, dans main.tex juste après amsthm :

latex
% --- Theorem Environments ---
\newtheorem{proposition}{Proposition}
\newtheorem{definition}{Definition}
\newtheorem{hypothesis}{Hypothesis}

(style amsthm par défaut plain : titre gras, corps italique ; numérotation globale sans section ; options \begin{proposition}[Absence of arbitrage]\label{prop:no_arb} ; une preuve en prose sans environnement proof). WP10 a une annexe de dérivations (\appendix + \section{Measurement-error bounds and first stage}) en prose + équations numérotées.

Convention proposée pour WP18 (cohérente avec WP8 et la typographie Times / amsthm du gabarit) :

latex
% --- Theorem Environments (WP18) ---
\theoremstyle{plain}
\newtheorem{proposition}{Proposition}
\newtheorem{lemma}{Lemma}
\newtheorem{corollary}{Corollary}
\newtheorem{theorem}{Theorem}
\theoremstyle{definition}
\newtheorem{assumption}{Assumption}
\newtheorem{definition}{Definition}
\theoremstyle{remark}
\newtheorem{remark}{Remark}
  • Numérotation globale (Proposition 1, 2, …, Assumption 1, …), comme WP8 ; pas de numérotation par section.
  • Assumption et Definition en style definition (titre gras, corps romain) pour les distinguer visuellement des résultats ; Proposition/Lemma/Corollary en plain (corps italique). Titres entre crochets : \begin{proposition}[Ownership threshold].
  • Preuves : environnement proof d'amsthm (« Proof. … ∎ ») dans paper/appendix_proofs.tex (inclus via \input{appendix_proofs} après \begin{appendices}), avec \begin{proof}[Proof of Proposition~\ref{prop:threshold}]. Les lacunes de preuve sont signalées explicitement dans l'énoncé (« (proof gap: …) ») ou par un remark.
  • Labels : prop:, lem:, cor:, ass:, def:, rem:. Renvois : Proposition~\ref{prop:…}, Assumption~\ref{ass:…}.
  • Les constats numériques ne sont jamais dans un environnement de théorème (CLAUDE.md : « do not call simulation findings theorems ») ; on les énonce en prose (« Result 1 » sans environnement) ou dans une liste \paragraph.

# 7. Citations et bibliographie

  • natbib[authoryear,round,semicolon] + \bibliographystyle{aer} dans 15/17 WP (WP2 et WP7 : \bibliography{references} sans \bibliographystyle visible dans main.tex — dérogation à noter si reproduite ; WP18 suit le gabarit : aer).
  • Usage : \citet{} pour les citations sujets (« \citet{iacoviello2005house} shows… ») et \citep{} entre parenthèses ; jamais \cite{}. Ratios observés WP2 75/83, WP5 75/58, WP10 57/34, WP16 52/26.
  • Clés : minuscules auteurYYYYmotclé (WP10 : paglin1972equity, cheng1970common) ou auteurYYYY (WP16). WP18 : auteurYYYYmotclé (premier auteur, année, premier mot significatif du titre), DOI dans chaque entrée, champ url seulement pour les working papers sans DOI (NBER, Bank of Canada, SSRN), note pour les versions WP. Taille observée : 52–94 entrées, 43–61 avec DOI. REVISION-PROTOCOLE : zéro référence non vérifiée ; source de vérification consignée (ici research/literature_matrix.csv, colonne verified_via, et journaux JSON bruts dans research/verification/).
  • \newpage \bibliography{references} avant l'annexe.

# 8. Annexes

Deux usages coexistent : \usepackage[toc,page]{appendix} + \begin{appendices} … \end{appendices} (WP16, WP8 : page « Appendices » puis \section{Additional tables} → « Appendix A ») et \appendix + sections (WP10). Le gabarit charge le paquet appendix ; WP18 utilise \begin{appendices} avec \input{appendix_proofs} (preuves), \input{appendix_computation} (algorithmes, tolérances, diagnostics) puis \input{appendix/appendix} (tables et figures supplémentaires), conformément au plan de répertoire du CLAUDE.md. Équations d'annexe numérotées en continu (pas de \numberwithin dans la série).

# 9. Compilation

paper/Makefile (latexmk, clean, distclean) + .latexmkrc du gabarit (pdf_mode=1, pdflatex -interaction=nonstopmode -halt-on-error -synctex=1, bibtex_use=2, @default_files=('main.tex')). Critère HARMONISATION §6 : cd paper && make sans !, sans citation/référence indéfinie ; page 1 = « Working Paper No. 18 », titre, auteur, « October 2026 », « Version 1.0 » ; page 2 = Abstract / Keywords / JEL. Le Makefile racine de WP18 (make paper) appellera cd paper && latexmk. Longueur observée des PDF : 39–82 pages (médiane ≈ 50), cohérent avec la cible 30–45 pages de texte principal + annexes.

# 10. Dérogations prévues pour WP18 (à reporter dans README « Notes »)

  1. Papier théorique : pas de section « Data » ; une section « Numerical algorithm, calibration and verification » la remplace.
  2. Environnements amsthm étendus (Assumption, Lemma, Corollary, Remark, proof) par rapport à WP8.
  3. Annexes séparées appendix_proofs.tex et appendix_computation.tex à la racine de paper/ (exigence du CLAUDE.md), en plus de appendix/appendix.tex.
  4. scripts/ numérotés du standard remplacés par src/*.py + Makefile + configs/*.yaml (exigence du CLAUDE.md) ; à documenter dans le README (« Quick start » = make all).