Your Guide to the Revamped Python Insider Blog: Contributing and Navigating the New Setup

Introduction

The Python Insider Blog has moved to a new home at blog.python.org, backed by a Git repository that makes contributing easier than ever before. All 307 posts from the old Blogger platform have been migrated, and old URLs automatically redirect. Your RSS feed will continue to work with the new feed URL: https://blog.python.org/rss.xml. This guide walks you through everything you need to know to read, contribute, and help maintain the blog.

What You Need

• A GitHub account – Required for forking the repository and submitting pull requests.
• A text editor – Any plain text editor works (VS Code, Notepad++, even nano).
• Basic familiarity with Markdown – Posts are written in Markdown files.
• Optional: Git knowledge – You can use the GitHub web interface or Git command line.
• Optional: Node.js and npm – If you want to preview your post locally using Astro.

Step-by-Step Guide

1. Step 1: Update Your RSS Reader

   If you were subscribed to the old feed, your reader should automatically pick up the new feed. In case it doesn't, manually update the feed URL to https://blog.python.org/rss.xml. No further action is needed – all old links redirect.

2. Step 2: Fork the Repository

   Navigate to https://github.com/python/python-insider-blog and click the "Fork" button in the top-right corner. This creates your own copy of the blog's source code under your GitHub account.

3. Step 3: Create a New Post Directory

   In your forked repository, go to the content/posts/ directory. Create a new folder named with your post's URL slug (e.g., my-python-update). Inside that folder, create a file named index.md. This will be your post file.

4. Step 4: Write Your Post in Markdown

   Open index.md in your text editor. Add YAML frontmatter at the top for metadata – title, date, authors, and tags. Write the content below the frontmatter using standard Markdown. Here's the required structure:

   ---
   title: "Your Post Title"
   date: "2025-04-13"
   authors: ["Your Name"]
   tags: ["release", "sprint"]
   ---
   
   Your post content here...

   If your post includes images, place them in the same directory as index.md and reference them with relative paths.

5. Step 5: Open a Pull Request

   Commit your changes to your forked repository and open a pull request against the original python-insider-blog repository. Include a clear description of your post. The maintainers will review and merge it once everything looks good.

6. Step 6: Report Issues or Submit Fixes

   If you notice broken links, missing images, or formatting errors from the migration, file an issue on the repository. You can also submit a pull request directly with your fixes – contributions are welcome!

Tips

• Preview locally (optional): If you have Node.js and npm installed, clone the repo, run npm install followed by npm run dev, and preview your post at http://localhost:4321 before submitting.
• Use Keystatic CMS: During local development, you can enable a visual editor by running npm run dev:keystatic. This provides a user-friendly interface for writing posts without raw Markdown – but it's entirely optional.
• Read the README: The repository's README contains more details on frontmatter fields and local setup. Refer to it if you need additional guidance.
• Keep images small: While there's no strict limit, compressing images helps keep the repository lean and deployment fast.
• Follow the style: Look at existing posts for tone and formatting cues – the blog uses Tailwind CSS for styling, but your Markdown is automatically rendered.

With these steps, you're all set to read, contribute, or help improve the new Python Insider Blog. Happy writing!