Fix non-consecutive heading levels in ProblemSet pages - #5
Conversation
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 9e6bdf3612
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| ## 1. Capital Structure | ||
|
|
||
| #### 1-1 Literature Review | ||
| ## 1-1 Literature Review |
There was a problem hiding this comment.
In this page, the 1-1/2-1/etc. question headings were promoted from #### to the same H2 level as their parent theme headings, so the Jupyter Book/page outline now lists “1-1 Literature Review” as a sibling of “1. Capital Structure” instead of under it; this flattens the whole Corporate Finance problem-set hierarchy and makes the theme grouping disappear. Since the parent headings are now H2, these nested question headings should be H3 rather than H2.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Pull request overview
This PR aims to eliminate non-consecutive heading-level jumps (e.g., H1→H3) in the ProblemSet Markdown pages to improve generated book structure (TOC/navigation/accessibility) in TeachBooks.
Changes:
- Promotes ProblemSet main sections from H3 (
###) to H2 (##) across the listed pages. - Updates heading levels throughout the documents while preserving the existing content text.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| PhD-Course/book/ProblemSet/Theoretical Asset Pricing.md | Converts numbered top-level sections from H3 to H2 to avoid H1→H3 jumps. |
| PhD-Course/book/ProblemSet/Microeconomics.md | Promotes main sections from H3 to H2 for consecutive heading levels. |
| PhD-Course/book/ProblemSet/Empirical Asset Pricing.md | Promotes main sections from H3 to H2 for consecutive heading levels. |
| PhD-Course/book/ProblemSet/Econometrics.md | Promotes main sections from H3 to H2 for consecutive heading levels. |
| PhD-Course/book/ProblemSet/Corporate Finance.md | Promotes main sections, but also flattens previously nested subsections to H2 (see comments). |
Comments suppressed due to low confidence (18)
PhD-Course/book/ProblemSet/Corporate Finance.md:227
- This appears to be a subsection under “## 1. Capital Structure”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 1-2 Research Proposal
PhD-Course/book/ProblemSet/Corporate Finance.md:301
- This appears to be a subsection under “## 1. Capital Structure”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 1-3 Mechanism Question
PhD-Course/book/ProblemSet/Corporate Finance.md:377
- This appears to be a subsection under “## 1. Capital Structure”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 1-4 Theory Comparison
PhD-Course/book/ProblemSet/Corporate Finance.md:464
- This appears to be a subsection under “## 2. Payout Policy”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 2-2 Research Proposal
PhD-Course/book/ProblemSet/Corporate Finance.md:560
- This appears to be a subsection under “## 2. Payout Policy”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 2-3 Mechanism Question
PhD-Course/book/ProblemSet/Corporate Finance.md:643
- This appears to be a subsection under “## 2. Payout Policy”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 2-4 Theory Comparison
PhD-Course/book/ProblemSet/Corporate Finance.md:735
- This appears to be a subsection under “## 3. Seasoned Equity Offerings”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 3-2 Research Proposal
PhD-Course/book/ProblemSet/Corporate Finance.md:826
- This appears to be a subsection under “## 3. Seasoned Equity Offerings”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 3-3 Mechanism Question
PhD-Course/book/ProblemSet/Corporate Finance.md:896
- This appears to be a subsection under “## 3. Seasoned Equity Offerings”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 3-4 Theory Comparison
PhD-Course/book/ProblemSet/Corporate Finance.md:976
- This appears to be a subsection under “## 4. Labor and Corporate Finance”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 4-2 Research Proposal
PhD-Course/book/ProblemSet/Corporate Finance.md:1054
- This appears to be a subsection under “## 4. Labor and Corporate Finance”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 4-3 Mechanism Question
PhD-Course/book/ProblemSet/Corporate Finance.md:1125
- This appears to be a subsection under “## 4. Labor and Corporate Finance”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 4-4 Theory Comparison
PhD-Course/book/ProblemSet/Corporate Finance.md:1201
- This appears to be a subsection under “## 5. ESG and Climate”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 5-2 Research Proposal
PhD-Course/book/ProblemSet/Corporate Finance.md:1291
- This appears to be a subsection under “## 5. ESG and Climate”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 5-3 Mechanism Question
PhD-Course/book/ProblemSet/Corporate Finance.md:1363
- This appears to be a subsection under “## 5. ESG and Climate”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 5-4 Theory Comparison
PhD-Course/book/ProblemSet/Corporate Finance.md:1465
- This appears to be a subsection under “## 6. AI and Corporate Finance”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 6-2 Research Proposal
PhD-Course/book/ProblemSet/Corporate Finance.md:1569
- This appears to be a subsection under “## 6. AI and Corporate Finance”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 6-3 Mechanism Question
PhD-Course/book/ProblemSet/Corporate Finance.md:1627
- This appears to be a subsection under “## 6. AI and Corporate Finance”. Keeping it as H2 (
##) makes it a sibling of the parent section and flattens the document hierarchy/TOC. Per the PR description, convert theseX-Ysubsection headings from H4 to H3 (###).
## 6-4 Theory Comparison
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ## 1. Capital Structure | ||
|
|
||
| #### 1-1 Literature Review | ||
| ## 1-1 Literature Review |
| ## 2. Payout Policy | ||
|
|
||
| #### 2-1 Literature Review | ||
| ## 2-1 Literature Review |
| ## 3. Seasoned Equity Offerings | ||
|
|
||
| #### 3-1 Literature Review | ||
| ## 3-1 Literature Review |
| ## 4. Labor and Corporate Finance | ||
|
|
||
| #### 4-1 Literature Review | ||
| ## 4-1 Literature Review |
| ## 5. ESG and Climate | ||
|
|
||
| #### 5-1 Literature Review | ||
| ## 5-1 Literature Review |
| ## 6. AI and Corporate Finance | ||
|
|
||
| #### 6-1 Literature Review | ||
| ## 6-1 Literature Review |
Summary
This PR fixes non-consecutive heading levels in all five ProblemSet pages.
Changes
Verification
PhD-Course/book/ProblemSet.git diff --checkpasses.Closes #2