<aside> 🤖
Want your article to be the one AI tools cite? Read this too → Content SOP: Articles AI Cites, Not Replaces / コンテンツ方針SOP：AIに「選ばれる記事」をつくる
This guide covers style and structure. The Content SOP is our reference for writing articles that AI search tools pick as a source: a clear answer up front, Japanese terms, sources, and “Last verified” dates. Use both together.
AIに「選ばれる記事」の参考はこちら → コンテンツ方針SOP（上のリンク）。このガイドは文体と構成のルールです。AI検索に引用元として選ばれる記事の書き方（冒頭の答え・日本語の用語・出典・Last verified）はSOPにまとめています。両方を併せて使ってください。
If anything here doesn't work in practice, share it with the team. / 実際にやってみて合わない点があれば、チームで共有してください。
</aside>
Please follow these guidelines when writing articles for Japan Dev.
Please use a simple writing style.
You should write like you speak, aiming for a 3rd - 5th grade reading level. Use short sentences, short paragraphs and simple words. Include bullets, numbered lists, and tables where possible.
Copy your writing into Hemingway App to check if it’s simple — it will tell you if you’re using overly complex words, long sentences etc.
Paragraphs should be no more than 3 lines. And while your average sentence length should be short, please vary sentence length so your writing doesn’t feel monotonous.
Make sure the article flows naturally and uses a conversational tone. If you read it out loud, it should sound natural and have no jarring transitions. This article is a good example of conversational prose that flows well and entices you to keep reading.
This article contains a great overview of the simple style we’re aiming for.
Every sentence must add value to your article. Please read through your work and remove any unnecessary words or sentences. There should be no fluff left when you submit it.
Avoid adverbs. Instead, include concrete statistics or facts. The same goes for most adjectives.