Qiita記事にさりげなく（けど、わかりやすく）環境を記載する - Qiita

はじめに 先日、@uhooi さんの以下のツイートを見た時に、おっ自分と同じ悩みだなーと思い、Qiita記事の「どこに」、「どうやって」、環境を書くといいのか、少し考えてみました Qiitaに記事を投稿するときにいつも悩むのが「環境」を書く位置なんだよな バージョンによって動作が異なることもあるから書くんだけど、流れをぶった切ってしまうことが多いhttps://t.co/TbpySzD4S3 pic.twitter.com/MI6kc36E8H — ウホーイ (@the_uhooi) August 20, 2020 さりげなく（けど、わかりやすく）環境を記載する方法 過不足なく簡潔に環境を記載する方法を模索した結果、OSSのREADME.mdでよく利用されているbadgeサービス（Shields IOやBadgenなど）を利用して、環境を記事の1番上にbadge表示することにしました。1

[metatrading]

このアイディア自体は良い。Qiitaが方針として環境は書きましょう。とガイドライン的に記載しているんだけど、だったら書けるように簡便化してくれと思う。

[H_Yamaguchi]

個人的には別に最初に堂々と大きく書いてくれてよいと思うのだが、そうすると環境が異なる人には読まれずに「いいね」もらえないから目立たなくしたいってことなのかな。

[noritada]

Shields.ioのバッジを頭に置くのは、GitHubのREADMEだと結構やられているが、流れをぶったぎらず目立ちすぎずという意味で、確かに記事でも使える方法かも。

[hrksb5029]

素晴らしいアイディアありがとうございます

[sho]

Shields.ioのサービスは、Qiitaより長生きするかしら?

[suquiya0]

ふむふむ。

[takasian_pride]

“e”

[kura-2]

冒頭のほうに前提条件として書かれていれば、そんなに流れを切られた感はないなあ。興味あるなしによるのかもだが。

[htbman]

概要の次にテーブルで書いてるな。流れを切ると感じるのは余計なおしゃべりを入れるからでは