For members
Contribute to the library
Every pitch, session, macro outlook, quant presentation, and glossary term lives as plain markdown in a public repository. To add or improve content, fork the repo, write your MDX, and open a pull request — two senior members review and merge.
Workflow
Three steps from idea to published
01
Fork & branch
Fork the repository on GitHub and create a feature branch for your contribution.
02
Write & preview
Add your MDX in /content. Run pnpm dev locally to preview before submitting.
03
PR & review
Open a pull request. Two senior members review for accuracy, clarity, and consistency.
What you can add
Five content types
Pitches, sessions, macro outlooks, and quant presentations are the four content categories the club publishes. Glossary entries support all four.
An investment pitch teaching page
A teaching walkthrough of a past pitch — annotated slides, the senior questions, what the team learned answering them.
/content/pitches/<semester>/<ticker>/index.mdx
A learning session
A focused lesson on one concept or method. Use Callouts, SelfChecks, DeepDives, FormulaBlock. 8–15 minutes of read time.
/content/sessions/<slug>.mdx
A macro outlook
A periodic reading of the macro backdrop — rates, growth, liquidity. Tagged by period and (optionally) region.
/content/macro/<slug>.mdx
A quant presentation
A quantitative piece — factor work, backtesting, ML, options. Same shape as a session, with quant-specific tags.
/content/quant/<slug>.mdx
A glossary entry
A short, precise definition of a term used across the library. Two sentences max. Link related items where the concept is explored.
/content/glossary/terms.json
MDX components
Building blocks
Every page can use these components inside MDX. Full usage examples live in CONTRIBUTING.md.
<Callout>
Pulled-out box
Surface a key insight, a warning, a self-question, or a definition. Four variants.
<SelfCheck>
Collapsible self-test
Question shown, answer hidden until clicked. The only interactive learning element in v1.
<DeepDive>
For the curious
Optional deeper section that doesn't break the main reading flow.
<KeyTerm>
Inline glossary link
Hover shows the short definition; click jumps to the glossary entry.
<FormulaBlock>
Rendered LaTeX
KaTeX-rendered math for DCF, WACC, CAPM, and other equations.
<PitchSlide>
Annotated slide
A slide image with positioned hotspots. Hover or tap to reveal teaching commentary.
<MetricsTable>
Finance table
Right-aligned, monospace tabular figures, with optional row highlighting.
<ProsCons>
Catalysts vs risks
Side-by-side layout mirroring the Investment Thesis slide format.
Review
Two senior approvals to merge
We protect the bar with people, not gates. Every PR needs two senior member approvals before it merges. Reviewers check accuracy, clarity, correct use of the MDX components, and consistency with existing style.
What reviewers look for
- 01Numbers tie out — every figure has a source or a calculation.
- 02Concepts are introduced before they're used.
- 03Self-checks test understanding, not memorization.
- 04Tone is professional and confident — never breezy.
Ready?
Read CONTRIBUTING.md for the full authoring guide.
It includes copy-pasteable templates, full examples of every component, naming conventions, and the review checklist.