Contribute

What We're Looking For

Three core criteria—match any one:

• Information-leading: you're earlier than the Chinese community and can explain clearly. E.g., paper deep-dive within a week of release, hands-on writeup right after a new tool launches.
• Compelling explanations: abstract concepts paired with analogies, visualizations, code—readers should think "aha, that makes sense" instead of "I'm lost".
• Systematic synthesis: connecting scattered knowledge points. E.g., "the journey from perceptron to Transformer" type retrospectives.

Process

1. Open an issue with your idea — on GitHub, describe what / why / rough outline. We reply within 24h.
2. Branch and draft — fork → new branch → create MDX file in site/src/content/learn/en/.
3. Submit PR — when done, open PR with 1-2 lines about your key points.
4. Review + merge — we read, give feedback, may suggest small changes. Most PRs merge in 1-3 rounds.
5. Credit + publish — your name + GitHub/Twitter appear on the article and on Contributors.

Style Guide

Voice

• Conversational: write to a smart but non-expert friend. Use "you", "we".
• Have a take: not Wikipedia-style neutrality. We want your perspective.
• No flexing: explain terms the first time they appear.

Structure

• Open with 1-2 paragraphs on why this matters.
• H2 sections using "Stop 1 / Stop 2" or "Why / How / Limits" progression.
• Code snippets short and runnable; long code → GitHub gist or repo link.
• End with a <Callout> block of the one thing to remember.

Frontmatter Schema

Learning article (learn/en/)

---
title: 'L4-13 RAG in Production'
description: 'One sentence summary (used in cards and SEO)'
level: 'L4'                  # L0-L7
chapter: 13
readingTime: 12              # minutes
difficulty: '🐣'             # 🥚 easy 🐣 medium 🐥 advanced
author: 'Your Name'
publishDate: 2026-09-01
tags: ['RAG', 'engineering', 'L4']
related: ['l4-03-rag', 'l4-04-agent']  # must be existing slugs
draft: false
---

Paper (papers/)

---
title: 'Mamba 2: SSM Revival'
authors: ['Albert Gu', 'Tri Dao']
arxivId: '2405.21060'
venue: 'ICML 2024'
year: 2024
tldr: 'One sentence summary'
tags: ['Mamba', 'SSM', 'must-read']
hallOfFame: true
publishDate: 2026-09-01
---

FAQ

Compensation?

None currently. HelloAI is non-profit. If donations / sponsorships happen in the future, we'll split proportionally to contributions. But as a contributor, your byline + links follow the article.

Republishing?

CC BY-NC-SA 4.0—free with attribution + non-commercial + same license. Contact us for commercial use.

Can I use AI to write?

Yes—but you must do fact-checking, logical structuring, style tweaking. Readers can tell AI-slop from carefully-crafted writing. AI-assist OK, AI-ghostwriting not OK.