SPB Git forge
spboucher.ai ↗

spb/wp19_uqo

Public
0commits 0branches 0releases
0 Bsize
maindefault branch
—last push
9.7 KB
View source Raw Blame History

# WP19 — Style audit of the UQO Working Paper series (Phase 0)

Date: 2026-10-20. Sources inspected locally: the 17 compiled papers in ~/Desktop/Recherche-UQO/{immobilier,finance}/*/paper/ (main.tex, sections/, appendix/, tables/, references.bib, main.pdf), the WP18 skeleton (same day, no PDF yet), the template _modele-working-paper/, and the series standard HARMONISATION.md (2026-10-17) with REVISION-PROTOCOLE.md. Detailed reading: WP2 (decoding-real-estate-descriptions), WP5 (airbnb-rents-housing-pressure), WP8 (polymarket-arrow-debreu, the only WP with theorem environments), WP10 (assessment-gap-quebec), WP16 (sales-comparison-validation), WP18 skeleton. The other papers were inspected by grep (preamble, \WP… metadata, floats, bibliography style, page counts via mdls). Remote check: https://git.spboucher.ai/raw/wp2_uqo/main/paper/main.pdf → HTTP 200 (pattern works); wp18_uqo → 404 (no PDF yet). The local copies are the primary source; nothing inaccessible was relied upon.

# 1. Facts verified by grep over the 17 main.tex files (2026-10-20)

Item Observation
Document class \documentclass[12pt,letterpaper]{article} in 17/17
Bibliography natbib[authoryear,round,semicolon]; \bibliographystyle{aer} in 15/17 (WP2, WP7: no explicit style in main.tex)
Date macro \WPdate{October 2026} in 17/17 (never \today)
Theorem environments only WP8: \newtheorem{proposition}{Proposition}, {definition}, {hypothesis} (amsthm default plain, global numbering)
Page counts (PDF) 39–82 pages, median ≈ 50
Bibliography size 46–125 entries (median ≈ 66)
Number macros WP16 \input{tables/numbers} → \newcommand{\nSalesRaw}{456,950} generated by a script
Floats \begin{table}[H], \centering, \caption{…} before the tabular, \label{tab:…}, \small; figures \includegraphics[width=\textwidth]{fN_slug.pdf} (vector PDF)
Appendix \usepackage[toc,page]{appendix} + \begin{appendices} … \end{appendices} (WP8, WP16); \appendix (WP10)

# 2. Title page, numbering, metadata

  • paper/sections/titlepage.tex = exact copy of _modele-working-paper/sections/titlepage.tex (logo 3.5 cm; "Université du Québec en Outaouais / Département des sciences administratives" in \footnotesize\textsc; "Working Paper No.~\WPnumber"; title \LARGE\bfseries; optional subtitle \large\itshape; author \large; affiliation, \href{mailto:} e-mail, address; date "Month YYYY"; "Version x.y"; page 2 = rule, Abstract, Keywords:, JEL Classification:, rule; \thispagestyle{empty} on both pages).
  • WP19 uses \WPnumber{19} (HARMONISATION §1: one number = one paper, 1–18 taken; WP18 = housing-leverage-intergenerational-inequality). spbgit repository wp19_uqo.git (to be created when the gateway is reachable).
  • Mandatory macros in main.tex: \WPnumber, \WPtitle, \WPsubtitle, \WPdate, \WPversion, \WPabstract, \WPkeywords, \WPjel, \WPauthor, \WPaffiliation, \WPemail, \WPaddress. Affiliation / e-mail / address are the template strings and are not modified: Département des sciences administratives\\ Université du Québec en Outaouais, simon-pierre.boucher@uqo.ca, Gatineau -- Pavillon Alexandre-Taché\\ 283, boulevard Alexandre-Taché\\ Gatineau, Québec, Canada J9A 1L8. Single author Simon-Pierre Boucher. No acknowledgments, grants or co-authors appear in any single-author WP; none will be invented for WP19.
  • \WPdate{October 2026}, \WPversion{1.0}, 5–8 keywords in lower case except proper nouns, JEL codes separated by commas.

# 3. Preamble and typography (common to the series)

inputenc utf8, fontenc T1, babel english; geometry 1 in margins; mathptmx + microtype; setspace \onehalfspacing; amsmath, amssymb, amsthm; booktabs, tabularx, multirow, threeparttable, siunitx; graphicx, subcaption, float; xcolor[dvipsnames] + hyperref (colorlinks NavyBlue); caption (small, bold label, period separator, justified); fancyhdr (centred page number, no rule); titlesec (\section = \large\bfseries "1.", \subsection = \normalsize\bfseries, \subsubsection = \normalsize\itshape); appendix[toc,page]; enumitem nosep. WP19 keeps the template preamble verbatim and only adds theorem environments and \graphicspath.

# 4. Abstract, keywords, JEL

Single-paragraph abstract of 150–250 words on page 2, real results only (REVISION-PROTOCOLE: no "novel", "comprehensive", "first"). JEL codes observed in the real-estate papers: R21, R31, R32, R51, R52, H22, H71, C21. WP19 candidates (brief): R31, R21, D83, G12, G51 — D83 (search; learning; information) and R31 (housing supply and markets) are clearly relevant; G12 (asset pricing) and G51 (household finance: housing) are kept only if the financing extension survives; C63 (computational techniques) is added for the numerical part. Final choice recorded in research/results_audit.md.

# 5. Section structure

Observed: separate files in paper/sections/ (introduction.tex, literature.tex, data.tex, methodology.tex, results.tex, robustness.tex, discussion.tex, conclusion.tex; WP5/WP15 use numeric prefixes). English headings ("Introduction", "Related literature"/"Literature review", "Methodology", "Results", "Robustness", "Discussion" with "Mechanisms"/"Policy implications"/"Limitations", "Conclusion"). WP8 inserts theoretical.tex ("Theoretical framework").

WP19 adaptation (theoretical paper, no data section) — files: introduction.tex, literature.tex, benchmark.tex (institutional intuition and frictionless benchmark), model.tex (environment, value functions, bargaining, equilibrium), propositions.tex, numerical.tex (algorithm, parameterisation, verification), baseline.tex, counterfactuals.tex (arrival, financing, bargaining, matching, entry, heterogeneity, dynamics, selection, posted prices, sensitivity), welfare.tex, conclusion.tex (limitations, falsifiable predictions). Academic prose without bullet lists in the body; numbered, cross-referenced equations (\eqref); labels sec:, eq:, fig:, tab:, prop:, lem:, cor:, ass:, def:, rem:.

# 6. Figures and tables

  • Figures: \begin{figure}[H], \centering, \includegraphics[width=\textwidth]{figNN_slug.pdf}, descriptive caption of 1–3 sentences after the graphic (stating what is simulated and that the objects are model-generated), \label{fig:…}. Vector PDF in paper/figures/; PNG copies for the README. Generated by src/plotting.py from results/processed/*.csv, never drawn by hand.
  • Tables: \begin{table}[H], \centering, \caption before, \label, \small/\footnotesize, body \input{tables/<name>} generated by src/tables.py (tabular + booktabs, no vertical rules), notes via threeparttable/tablenotes. Wide tables through \resizebox{\textwidth}{!}{…}. No hand-typed table.
  • Numbers in the prose: paper/tables/numbers.tex with \newcommand macros generated from the result files (WP16 mechanism), so that each number quoted in the text is traceable to results/.
  • Protected commas in titles: 140{,}931.

# 7. Theorem environments (new for WP19, consistent with WP8 and the amsthm/Times template)

latex
\theoremstyle{plain}
\newtheorem{proposition}{Proposition}
\newtheorem{lemma}{Lemma}
\newtheorem{corollary}{Corollary}
\theoremstyle{definition}
\newtheorem{assumption}{Assumption}
\newtheorem{definition}{Definition}
\theoremstyle{remark}
\newtheorem{remark}{Remark}
\newtheorem{conjecture}{Conjecture}

Global numbering as in WP8; titles in brackets; proofs in amsthm proof environments inside paper/appendix/appendix_proofs.tex (\begin{proof}[Proof of Proposition~\ref{prop:…}]). Numerical findings are never placed in theorem environments: they are stated in prose as "Result N" or, when unproved but systematic, as a conjecture.

# 8. Citations and bibliography

\citet{} for textual, \citep{} for parenthetical citations; never \cite{}. Keys authorYYYYkeyword (first author, year, first significant title word), DOI in every entry that has one, url only for working papers/books without DOI, note for WP series. REVISION-PROTOCOLE: zero unverified reference; verification evidence stored as raw Crossref JSON in research/verification/ and listed in research/literature_matrix.csv (verified_via). aer.bst requires a references.bib without a leading % comment line (gotcha recorded in the series memory). \newpage \bibliography{references} before the appendices.

# 9. Appendices

\begin{appendices} with \input{appendix/appendix_proofs} (proofs), \input{appendix/appendix_computation} (algorithms, tolerances, convergence diagnostics), \input{appendix/appendix_extra} (additional tables and figures). Appendix equations numbered continuously.

# 10. Compilation

paper/Makefile (latexmk, clean, distclean) + .latexmkrc from the template (pdf_mode=1, pdflatex -interaction=nonstopmode -halt-on-error -synctex=1, bibtex_use=2). Acceptance (HARMONISATION §6): cd paper && make with no !, no undefined citation or reference; page 1 shows "Working Paper No. 19", title, author, "October 2026", "Version 1.0"; page 2 shows Abstract / Keywords / JEL. Root Makefile: make test, make simulate, make figures, make tables, make paper, make all.

# 11. Deviations from the standard (to be reported in README "Notes")

  1. Theoretical paper: no "Data" section; numerical.tex replaces it.
  2. Extended amsthm environments relative to WP8.
  3. scripts/NN_*.py pipeline replaced by src/*.py modules + Makefile + config/*.yaml (brief requirement).
  4. Additional research/ directory (literature matrix, novelty audit, proofs, validation, results audit) kept in git.