Weekly Q&A Workflow

How to add a new Q&A

Each week, create a new markdown file in the _qa/ folder following this structure:

File naming

• Format: _qa/YYYY-MM-DD-slug.md
• Example: _qa/2026-05-22-faith-statistics.md

Front matter

---
layout: qa
date: 2026-05-22
title: "Question topic 1? Question topic 2?"
roundup_issue: "r486"
---

Content format

Use simple, narrative markdown:

**Name asked, "Your question here?"**

*One-line answer summary.*

Your detailed explanation and response. You can include multiple paragraphs.

### Subheading for sections

More details here. [Links work](https://example.com) like normal. _Italics_ for emphasis.

---

**Another name asks, "Next question?"**

*Answer summary.*

Explanation continues...

Structure

• Start each question block with **Name asked,** "Question?"
• Follow with *One-line answer summary.* in italics
• Write the explanation in narrative prose (2-5 paragraphs typically)
• Separate multiple Q&As with ---
• Use ### Subheading for section breaks within answers
• Use [link text](url) for links
• Use _italics_ for emphasis
• Use **bold** for important phrases

What happens automatically

1. The page builds at: /qa/2026/05/22/ (based on the date in front matter)
2. Navigation links: Previous/next arrows appear automatically if there are other Q&As
3. Index listing: Your new Q&A appears on /qa/ sorted by date (newest first)
4. CTAs appear: Roundup signup and question submission boxes automatically included

Roundup integration

In your Roundup issue, add a callout like:

This week’s Q&A: I answer questions about Protestant pastors and Catholic conversion in South America.
Read the answers →
Have a question? Send it to questions@justinlong.org

Tips

• Keep questions concise (1-2 sentences)
• Answer summaries should be punchy (one sentence)
• Explanations can be 2-5 paragraphs with citations
• Reference sources inline with links when possible
• Use _italics_ for publication names, quotes, emphasis
• Use h3 (###) for subsections within answers

Example complete file

See _qa/2026-05-15-protestant-pastors.md for a full example.