$\color{Red}{\huge \textbf{読ませる記事を書こう}}$
※AI生成の文章はどれだけ良くても論外と言う事で。
対象読者(普通に想定しなかったのでAIが雑に出した)
「技術記事を書いてみたけど反応が薄い人」
「AI丸投げ記事にモヤモヤしている人」
この記事のMarkDown。
https://qiita.com/EndOfData/items/8cf8f3eb8a1d2c3a9465.md
以下は必要なモノ
基本🌎
- 対象読者の明示
- ユースケースの明示
- 実体験から来るエピソード
- 適切な文脈での引用URL
↦例え本人が難しくて読めなくても公式リファレンスがあると信頼度が上がる。ここだけならAIで解釈させてもいいだろう。 - 幾ばくかのユーモア
- Code Blockの挿入
※以下はエアプログラミングで書いたから実は動かない。
コメントは適度かつ詳細に。理解度に乏しい場合はAIにコメントだけ書かせても構わない。
///貴婦人を羊に変換する拡張メソッド
Public static SheepLady toSheepLadyMixer(this Sheep sorceSheep, Lady sorceLady)
{
var resultSheepLady = new SheepLady();
resultSheepLady.sheep = sorceSheep;
resultSheepLady.Lady = sorceLady;
return resultSheepLady;
}
internal class Sheep()
{
+ sheepLady = sheep()
}
//羊貴婦人Class 内部に公開プロパティ
Public class SheepLady
{
public Sheep sheepAttribute{get;set; }
public Lady LadyAttribute{get;set;}
}
internal class Lady
{
+ Sextial sextial{get;set;} = Gender.
}
diff_任意の言語名とすると+でシンタックスハイライトを入れることが出来る、
分岐🛣
- 長くするか短くするか
長文記事の場合、途中で飽きさせない工夫が必要
→ 全く無関係なモノを挿入しても別に構わない
こんな感じ
独自の工夫と差別化🔧
→サクッと読みたい場合は外部サイトに誘導することなくスライドを提示できる。
但し、Linkや折り畳みを開くなどは出来なくなる。基本的に写すだけ。
読者にはスライドを飛ばして記事本文は割と自由に読んでもらったり/サクッとスライドだけで読んでもらうという選択肢を提示できる。
ページ数は---を段落ごとに挟むことで増やせる。
- detailsで折り畳みを使う
特に長すぎたり、必要性の低いcode Blockを隠蔽したりするのに使う。
Codeと言うのは基本的に認知負荷が高い。Codeを読むのは基本だけど、無理に読んでもらう必要はなく任意に読んでもらうようにする。
<details><summary>Clickで展開</summary>
</details>
Csharp Code(Clickで展開)
SheepLady _sheepLady = new();
class SheepisLady
{
SheepLady sheepisLadyConvert(Sheep sorcesheep)
{
_sheepLady =sorcesheep.toSheepLadyMixer();
// AllSheep is Lady!!!
retutn _sheepLady;
}
}
class SheepLady
{
string sheeplady = nameof(sheeplady);
var setSextial = new Sextial();
Sextial sextial{get;set;} = setSextial.femail;
}
Public class Sextial
{
public string femaile {get; set;}= nameof(femaile);
public string mail {get; set;}= nameof(meil): ←これは使わない
}
記事内にYoutube動画を埋め込む💡
ちなみに開始位置オプションを指定することで、見せたいシーンから再生することが可能
例:便宜上改行してある
<iframe width="560" height="315" src="https://www.youtube.com/embed/yme2aPIPDDU?si=wTInu1ax8Binm56a&start=127"
title="YouTube video player" frameborder="0" allow="accelerometer;
autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture;
web-share" referrerpolicy="strict-origin-when-cross-origin"
allowfullscreen></iframe>
例:とあるお羊様の動画(先日紹介されたもの)
アプリの紹介には実際の動作を見せる動画を入れる
この場合だとD&DでMP4ファイルをドロップしますなど入れるともっと良かった。
記事本文を無理やり読ませるより、先に提示してしまった方が説得力が出しやすい。 読者は心理的にこのCodeが動作する保証が欲しいからである。
Mermaid等での図解🐡
あまり得意ではないのでLinkを貼る。
ググったらなかなか良いのが出たので。
トラブルシューティングを詳細かつ正確に書く
こんな時ぐらいはAIを活用してもバチは当たらない。但し詳細に実際の手順を記録したり、元のドキュメントを見つけるよう努めること。
AI出力でやってみてたまたま出来ました、一切ググってませんばかりではわざわざ読む価値がないし技術記事とは言わない。本音を言えばわざわざそんなもん書くなと思う。
書き終わったら
集客を考える。他人の記事を読みまくっていいね・ストック・コメントを入れるなどするのが良い。
記事は本気で読むこと AIの要約は最低限にしないと頭に入ってこない。
内容が高度過ぎて読解や理解が困難だったり用途が見えなければAIに補助させても良い。
SNSでの紹介などは基本として、とにかく他人を巻き込むのが基本戦略。
AI出力の自己満記事ばかりで碌に読まないのも居たりする。
ここ技術コミュニティのサイトなんだけど。 $\color{lightGray}{\small \textbf{〇ード〇レスかア〇ブロか〇てなかnoteで書けや的な}}$
AIに記事の評価をさせて問題点を洗い出させる
むしろここで一番AIを使いたい。
AIの強みは出力よりもレビューにある。問題点の洗い出しは生成AIモデルが最も得意とするところだ。
ただし修正をAIに丸投げしてはいけない。AIが出力する70点の記事は基本的にクソ記事である。AI臭がするからまだ本人が試行錯誤して書いた方がAIレビューで問題点が洗い出しやすい。
このようにすることで自分で書くだけよりも記事の完成度を高めることができ、いいね数/ストック数の増加につながる。
まとめ📚
AIは使っていいけどAIに雑に丸投げすな。
最後に読んでもらったお礼などを書く。
ありがとうございました<(_ _)>。
面白くなかったらフォロー解除、ブラウザバック、ミュートなどお願いします。
執筆時間:1時間ぐらい。
あとがき
思い付きのままに書いた記事です。あと自分でもなんか構成が雑になってきた気がするので文書化をと。
アドベントカレンダーの時期だけどアドベントカレンダーに入れる場所がない。




