読まれる技術ブログを書くヒント - 企業技術ブログ
忙しい業務の合間をぬって書く技術ブログ、せっかくなら多くの人に読まれたいですよね。 エンジニア向けメディアなど、企業のコンテンツマーケティング支援やHatena Developer Blogの編集サポートなども担当しているはてなの編集者に、読まれる技術ブログを書くヒントや、はてなで実践している工夫について聞いてみました。ブログを書く際に、よろしければ参考にしてみてください。 記事タイトルにこだわりましょう人は記事タイトルを見て、中身を読むか判断します。つまり、タイトルの書き方ひとつで読まれやすくもなるし、逆に損をすることもあるのです。読まれるブログを目指すとき、まず記事タイトルに注力することをおすすめします。 見出しを読み手への道標に活用しましょう「いま何の話をしているのか」読み手が迷わない道標として、見出しを活用しましょう。 目次を見て、各セクションにどんなことが書いてあるのかイメージで
プログラマーに贈る、わかりやすい文章を書くための技法 - LIVESENSE ENGINEER BLOG
これは Livesense Advent Calendar 2022 DAY 8 の記事です。 転職ドラフトでエンジニアをしている verdy_266 です。 僕の2022年を振り返ると、採用広報チームでの活動を無視することはできません。転職ドラフトの開発を行う傍ら、昨年末に採用広報チームにジョインし、記事の執筆や校正に多くの時間を割いてきました。 今まで記事を投稿したことがなかったこちらのブログにも共作含め5記事を投稿し、11月には Software Design への寄稿の機会をいただくこともできました。文章を書くことが思った以上に好きなんだなと発見があった年でもありました。 made.livesense.co.jp made.livesense.co.jp made.livesense.co.jp made.livesense.co.jp made.livesense.co.jp 弊
Twitter、文字数制限を4000字に拡張か イーロン・マスクCEO「Yes」と認める
マスクCEOがTwitter社を買収する以前の6月に同社は、画像やツイートを組み込める長文ブログ投稿機能「Twitter Notes」のテストを北米や英国の一部ユーザーに提供していた。マスクCEOは予告した新機能について「（Twitter Notesと）似たようなもの」（Something like that）としている。 関連記事 Twitterに“長文添付機能”追加へ マスク氏「メモ帳スクショを終わらせる」 イーロン・マスク氏が、ツイートに長文テキストを添付する機能を追加すると発表した。「メモ帳のスクリーンショットという愚行は終わりだ」としている。 Twitter、長文（2500文字）コンテンツ投稿「Twitter Notes」のテスト開始 Twitterは、画像やツイートを含む長文（2500文字まで）コンテンツを作成、投稿する機能「Twitter Notes」のテストを開始した。No
GitHubのREADMEの見た目をイケてる感じにする
どうも、hanetsukiです。 GitHubにはアカウントそれぞれにREADMEを乗せられるリポジトリがついているのはご存知でしょうか？ 以前から簡易的なプロフィールは掲載していたのですが、訪問していただいた方に「おっ！」っと思わせるようなREADMEにしたいと思い更新することにしました。 今回更新するにあたって何を使ったのかというのを忘備録的に残していきます。 これが今回完成したREADME 詳しいソースコードは、リポジトリをご覧ください。 Skill Icons 自分が持っているスキルなどを表示するときに便利。 他にもお気に入りの言語や、今学習の言語という使い方もできそうですね！ 詳しい利用方法は、https://github.com/tandpfun/skill-icons#readme をご覧ください Badge Generator Zennのフォロワー数の記載に利用しています。
朝日新聞、独自技術のデモサイト公開 要約AI、校正AIなど掲載
朝日新聞社は11月22日、同社の開発機関「朝日新聞社メディア研究開発センター」が独自開発した技術のデモサイト「朝日新聞Playground」を公開した。第1弾として、要約AI「TSUNA」や校正支援AI「TyE」を掲載している。 「TSUNA」は入力された文章の要約文や見出しを生成するAI。文字数指定に応じて出力を調整する機能も備える。30年以上の朝日新聞社の記事を学習させたAIで、社内では業務に活用しているという。 「TyE」は入力された文章の中に含まれる誤字脱字や文法ミスを検知するAI。朝日新聞社が持つ記事の編集履歴を学習させている。 今後も開発した技術のデモンストレーションを随時公開するとしている。 関連記事 朝日新聞、「bouncy」「Moovoo」手掛ける「朝日デジタルラボ」分社化 朝日新聞社は3日、ECサイト「Moovoo」（ムーブー）や動画メディア「bouncy」（バウンシー
文章の表記で「3点リーダー」（…）は二つつなげて使うものだと指摘された。その根拠があれば知りたい。 | レファレンス協同データベース
・『新しい国語表記ハンドブック（第九版）』のp260「様々な符号の使い方」の項目に3点リーダーの意味と用例が掲載されている。3点リーダ一つでの用例に続き、「又は二つ重ねる」という説明。 ・『朝日新聞の用語の手引 改訂新版』2019年発行のp163「ダッシュ（単柱）とリーダー」の項目には、「原則として2文字分にする」と表記されている。『朝日新聞の用語の手引 '05-'06年版』には記述は見つけられなかったが、3点リーダが二つ続いて表示されている部分が各所に見られた。 ・2005年発行の『読売新聞 用字用語の手引き』の「句読点と符合」の項目のp130には、「リーダーは必ず2字分で使」うという表記がある。2020年発行の第6版では「リーダーは2字分で使い」と、「必ず」の表記が無くなっている。 ・『編集校正小辞典』p208「リーダ」の項目には、二つつなげるという表記はないが「全角3点リーダ（……）
クリック数を10倍にする記事タイトルの付け方 - give IT a try
はじめに：クリックしたくなるのはどっち？ ブログやQiitaに何か記事を書く場合、記事のタイトルはとても重要です。 内容がいくら素晴らしくてもタイトル付けに失敗するとほとんど誰にも読まれない、ということが起こりえます。 たとえば、みなさんは以下の2つの記事があった場合、どっちをクリックしたくなりますか？ 「本日の学び」 「秒速で100億稼ぐ方法がわかった」 たぶん後者ですよね。 前者はクリックするまで内容が想像できないし、クリックしても自分に役立つ情報が載っている保証がありません。なので、ほとんどの人はクリックしてくれません。 一方、後者はクリックしなくても「秒速で100億稼ぐ方法が載ってるんだろうな」というのがわかりますし、「秒速で100億稼ぐ方法」は多くの人に取って役立つはずです（僕も知りたい）。 読者が得られる明らかなメリットをタイトルに含めよう というわけで、自分の記事を客観的に読
技術記事を書かないプログラマへ向けた記事
はじめに 今回の記事では効率的に技術記事を書くための具体的なテクニックは取り扱わない。技術記事を書くことのメリットや技術記事を書く上で重要なマインドセットを中心に徹底解説する。 要旨：プログラマーは積極的に技術記事を書くべき 私たちプログラマーは積極的に技術記事を書くべきだ。TwitterでもQiitaでもこのZennでも構わない。とにかく何でもいいので、自分の学びや気づきを記録してそれを公開する習慣をつけよう。自分で学んで得られた知識や気付き、新しい価値観をまとめる作業は自分にしかできない。 記事を書くべき理由 記事を書くべき理由はざっくり以下の通り。 知識が定着するから 説明する能力が上がるから プログラマーとしての人となり(興味のある技術やプログラミングに対する価値観、説明する能力など)を知られるから それぞれ順番に解説する。 知識が定着するから 知識を定着させるための最高の手段は、
エンジニアが自分用の小さな技術メモを残すべき理由とScrapboxの紹介 - uma_the390’s diary
簡単に結論 何度も調べる手間を減らすために小さな技術メモを残すのは大事 Scrapboxなら気軽に使えるようなUI/UXだからおすすめ 記事の背景 エンジニアとして働いていると、実際にコードを書いている時間よりも調査の時間が長いと思います。 新卒でエンジニアとして働き始めたときに、上司から「小さな技術メモを残す習慣をつけろ」と言われました。 いろんなツールを使って小さな技術メモをとってきたのですが、最終的にはScrapboxが一番しっくりきたので紹介したいと思い記事を書きました。 小さな技術メモとは 僕がこの記事で「小さな技術メモ」と言っているメモのイメージはこんな感じのメモです。 小さな技術メモ 内容のジャンルとしては主に以下のようなものです。 技術的な調査の結果分かった仕様 エラーの解決ログ 頻出のコードスニペット(RubyでGETリクエストするなど) 役に立った記事のブックマーク な
執筆者やライターに向けて、編集者からのお願い→原稿を書き終わったらチェックして欲しい点がこちら
中村明博（編集者） @naka727 【編集者からのお願い】 著者やライターさんへ、原稿が完成したら、 ・「という」をカット ・「と思います」をカット ・「こと」をカット ・「もの」をカット ・過剰敬語をカット できないか見直していただけないでしょうか。ざっとでもかまいません。関係者全員が幸せになります。なにとぞ、、！ 2021-03-05 12:14:24 中村明博（編集者） @naka727 【なぜこんなお願いをするか】 誰かが直さなければならないからです。その分、「磨き上げ」の時間が減り、本のクオリティーが落ちます。本の売り上げが落ち、関係者全員が不幸になるためです。 2021-03-05 14:37:22 中村明博（編集者） @naka727 さらに可能なら、 ・40字を超える長文は短く・簡潔にする ・「これから説明します」的な余計な前置きはカット ・「ひとつ・1つ」「ひとり・1人
スマホでのブログ更新がPCに全然追いつかない - 羆の人生記
スマホでもっと機動力を上げてブログの更新できたら強いよなってつくづく思う。はてなブログはスマホアプリあるけど、それがPC更新との差を埋めるものにはなっていない。 URL貼り付けや画像貼り付けひとつにしてもそうだし、範囲指定にしたってPCと比べるとそりゃーやりづらいという他はない。 ここまでIT技術が進歩しているにも関わらず、PCでの更新よりも強烈に劣ってしまうモバイルのブログ更新環境に切なさを覚えずにはいられん。 もし、スマホで気軽にPC並みのブログ記事を更新できたなら、もっともっと多くのユーザーが情報量を持ったリアリティな発信ができるはずなのだ。例えば全国行脚してその最中に体験したことを、ほかほかの臨場感を帯びさせてその場で日記にUPするなど。当然、他記事の引用やURL貼り付け、範囲指定やHTML装飾をサクサクと施して、である。 「文字だけでも十分じゃない？」あるいは「外付けキーボードを
LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
LINE株式会社は、2023年10月1日にLINEヤフー株式会社になりました。LINEヤフー株式会社の新しいブログはこちらです。 LINEヤフー Tech Blog こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。今日は、私が1文を書くときに気をつけていることや手法についてお話しします。 そして、この書き出しは、6月にmochikoさんが書いた「LINEの社内には「テクニカルライティング」の専門チームがあります」という記事のオマージュになっています。mochikoさんが書いた記事ですごいpvをたたき出したそうなので、人のふんどしで相撲を取ってみようという作戦で始めてみました。 この記事ではLINE社内で私が講師を務めた「LINE社内で大評判のテクニカルライティング講座」に沿って、わかりやすい1文を書くコツを紹介していま
「相当まともな文章を書いてきますよ」関西大学のゼミで配布されている『レポート・論文の基礎ルール』が本当に大切なことばかり
関大岩本ゼミのアドミン @iwasemi_kuuu マーケティングや経済学や実践的なビジネスを対面とオンラインとハイブリッドで学ぶ関西大学商学部岩本ゼミの非公式兼たまに公式アカウント。 アドミンの専門はMKTG(政策)論と学説史。 質問箱→peing.net/ja/iwasemi_kuuu Note→note.com/iwasemi iwamotozeminar.uijin.com リンク note（ノート） 岩本ゼミにおけるレポート・論文の書式の基本ルール｜関大岩本ゼミのアドミン｜note レポート及び論文では「基本的な能力を有した日本語ユーザーであれば誰でも理解できる（誤解しない）」精確な（＝精密で的確な）日本語を書くことが求められます。その能力を身に付ける第一歩として，以下のルールを必ず守ってください。中には瑣末なモノも含まれますが，これらを守るだけで添削・修正の手間も再提出の可能性
太古の昔、ブログは「文学」だった。 - 明晰夢工房
p-shirokuma.hatenadiary.com amamako.hateblo.jp 今日はこちらのエントリを読んで思ったことなどを。 ブログに商業化の波がやってくる前、この世界はただリアルには出せない、自分の思いのたけをぶつけるだけの場所だったように記憶している。もちろん観測範囲の問題はあるし、以前から商売のためにブログを書いていた人も、ブログを書籍化した人がいることも知っている。だが総じてブログ空間は、ただ書きたいこと、訴えたいことがあるから書く、という人が多くを占めていたように思う。 はっきり空気が変わり始めたと感じたのは、「ブログで自分語りなどしてはいけない」と主張する人たちが出てきた頃からだ。需要のないエントリなど書いてはいけないということだ。自分が書きたいかどうかではなく需要があるか、要はお金になるかが一番の関心事、という人たちが増えてきた。ブログをどう書こうと自由なの
ひたすら少数の者のために手紙を書くがいい - 関内関外日記
今週のお題「ブログ初心者に贈る言葉」 すばらしい詩人の一人である田村隆一はこう書きました。 沖にむかってどこまでも歩いて行くのだ そして ひたすら少数の者たちのために手紙を書くがいい 「新年の手紙」部分 私が十年とそこらブログというものを書いてきて、ずっと思っているのはこのことです。少数の者たちのために手紙を書く。こういった形で文章を世界中にさらけ出すにあたって、これ以外のことを考える必要はありません。 ブログを書こうという人など、それ自体が少数の者です。だから私は、いつものように少数の者のために書く。あなたのために書く。ブログを書こうなどという、少数の者のために。 初期衝動さえあればいい。その衝動がただひたすらにものを書くこと、だれかの目に触れさせること、それを持続させることにつながるのだから。最初の「公開する」ボタンを押した瞬間からそれは始まり、あなたが息絶えるまでそれは終わりません。
そうして私は書けなくなった - 或るロリータ
文章を書くのが好きだった。それに気がついたのは中学二年生の頃。それまで私は周りのクラスメイトと比べても文章が特別に上手いわけではなかったし、私より整理された思考を持ち、私より美しい表現ができる人は幾らでもいた。決して「文章が上手い人」と尋ねられたときに、クラスで真っ先に名前が挙がるような対象ではなかったのだ。 中学二年生になるまで、私は清く、健やかに生きることに何の疑いも持たなかった。みんなと同じように学校の勉強をこなし、本を読み、友人と遊び、恋もする。およそ少年として与えられる課題を日々まっとうした。努力さえすれば叶わないことなどないと思っていたし、事実、目の前に現れる課題のほとんどは、努力によって結実する類いのものであった。 ところが少年の私は気づいてしまう。このまま当たり前に生きていった先に、一体何があるのだろうか、と。明確な夢も、秀でた才能も見受けられなかった私に、親は決まり文句の
京アニ犯人の投稿発覚を受けて･･･手書き原稿にまつわるエトセトラ
リンク 京都アニメーション大賞 | 京都アニメーションホームページ よくあるご質問 | 京都アニメーション大賞 京都アニメーションでは幅広い層へ向けて発信するエンターテインメントな作品を広く募集致します。ジャンルはSF、ミステリー、ファンタジー、アクション、学園モノなど、一切問いません。「自分はこの作品で勝負したい！」という創作意欲に溢れた方からのご応募を心よりお待ちしております。 53 users 334 Q:手書き原稿で応募することは可能ですか？ Ａご応募いただくことは可能ですが、パソコン、ワープロ等を使用してご記入されることを推奨致します。手書き原稿の場合はA4サイズの400字詰め原稿用紙をご使用ください。 なお、手書き原稿の場合は、178～536枚が規定枚数となります。 原稿は返却いたしませんので、原本が必要な場合は必ずコピーをお送りください。
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
超簡単! 英語でバグレポート
誰がどう見てもそうとしか受け取れない文書術（公開版）
日本人の罫線好き
