Re:VIEWで書いた文章の校正をCircleCIとtextlintでGitHubのPRに自動コメントする仕組み - production.log
概要 技術書典でRe:VIEWを使っていたものの、文章を書き、textlintを回すというCI環境を整えることができませんでした。また、このCI環境は、ブログ執筆においても有効であるため、このタイミングで構築することにしました。 今回はRe:VIEWで書いた文章の校正をCircleCIとtextlintでGitHubのPRに自動コメントする仕組みを作ったのでその紹介をします。 概要 仕様🖋 構築手順👨💻 textlintの導入 CircleCIの設定 .circleci/config.yml textlintの実行とGitHubのPRヘコメント GitHubのアクセストークンを取得 GitHubのアクセストークンをCircleCIに設定 .circleci/review-textlint.sh 動作確認🚨 CircleCIの確認 GitHubのPRコメントの確認 まとめ✨ 仕様
広告関係4団体が「広告制作取引『受発注』ガイドライン」を策定 | 公益社団法人 日本アドバタイザーズ協会
広告関係4団体「新しい働き方」円卓会議 広告制作取引「受発注」ガイドラインを策定 広告業務に携わる関係者全員がこれまでの働き方を見直し、長時間労働を抑制するための取り組みとして、公益社団法人日本アドバタイザーズ協会、一般社団法人日本広告業協会、一般社団法人日本アド・コンテンツ制作協会、公益社団法人日本広告制作協会の広告関係4団体は「新しい働き方」円卓会議を第2回（12月8日）、第3回（1月11日）と開催し、「広告制作取引『受発注』ガイドライン」を策定いたしました。 広告制作業務における長時間労働削減のためには、受注/発注側の両者がお互いの立場を尊重し、業務を進めることが重要です。 このガイドラインは制作費や納期などの発注内容を事前に明確にし、適切なスケジュール管理のもと業務管理を行い、受注/発注両者が長時間労働の抑制に取り組むことを目的としたものです。それらを「受発注確認書」として電子メー
類似文字列検索ライブラリResemblaを公開しました - LINE ENGINEERING
LINEでClovaの開発をしている上村です。これはLINE Advent Calendar 2017の13日目の記事です。今日は文字列の話をします。 はじめに 与えられた文字列によく似たものを大きな文字列集合から探すということは、古典的でありふれていながら奥が深く難しい問題です。文字列の類似度を正確に見積もるには複雑な計算が必要ですが、膨大な量のコーパスが与えられたときも可能な限り高速に応答を返す必要があります。 検索する文字列の性質をよく把握することも、品質のよい類似文字列検索を行うためには極めて大切です。ここで、今回考える問題の例を見てみます。 この例では、1文字ずつ違いを見つけ出したり、単語単位で見たり、文全体が疑問文や否定文であるかどうかを調べ、それらを総合的に見ることで最終的な判断を下しています。文字だけを見た場合、1文字の違いによって全く違う単語になることは見つけられませんし
ちょっとだけ良い英語を書く - /dev/null/onishy
eeic Advent Calendar 13日目の記事です。 インターン・就活用の書類、論文など、そろそろ英語でポエムを書かなきゃと思っている人も多いでしょう。 良い英語のためには、本当はちゃんと文法を勉強した方が良いです。 でもそんなことは言ってられないと思うので、とりあえず英文を書く上で、知っておくだけでいつもよりちょっとだけ良い英語を書けそうなテクニックをいくつか挙げます。割と当たり前のことを言っているかもしれない。 本当は例文とかも色々挙げたかったけど、あまり時間がなかったので気が向いたら。 類義語辞書を使う（重要） 同じ表現を多用するのはボキャ貧です。アカデミック界隈の礼儀はあまり知らないが、therefore連弾が来ると普通の人はボキャ貧ワロスってなると思う。 例えば英語には順接の接続詞や副詞がたくさん用意されています。therefore, thus, hence, as a
技術書を作るための技術スタック | メルカリエンジニアリング
Mercari Advent Calendar 2017の3日目はmhidakaがお送りします。 Advent Calendarで空いてるところに収まったら12月3日は日曜日ということで、エンジニアの趣味的な話です。 筆者は技術的なブログや書籍を書くかたわら、技術書のためのイベントなどを開いてます。 技術を追求すること、プログラミング、まとめることが好きでモバイル分野で継続的に書籍を出版しています。 内容はおおむね同人誌作りへ適用している技術の話です。 書籍の作り方は出版社によっても違いますが、紹介する内容と同様の作り方をしている商業書籍もたくさんあります。 ここでは著者の目線から出版業界のテクノロジーをのぞいてみましょう。 作る楽しみと読者の視点 著者が本を書く動機は人それぞれですが技術を広めたい、たくさん売れたい、自分の知識をまとめたいなど目的を持って書き始めます。 また一方で書籍の目
エンジニア向けライティング講座。見落としやすい注意ポイントを徹底解説！ - エンジニアHub｜若手Webエンジニアのキャリアを考える！
エンジニア向けライティング講座。見落としやすい注意ポイントを徹底解説！ 個人が趣味で運営するサイトと、企業が事業として提供するサービスでは、責任の大きさが違います。守るべき法律やライセンスがあり、モラルが厳しく問われるだけでなく、掲載する情報の正確さ、分かりやすさに気を配ることも大切です。開発を業務とするときに、エンジニアリング以外でどんなことに気をつけるべきでしょうか。 こんにちは、Webエンジニアとして企業に勤めている池田（@ikenyal）です。 この記事では、サービス開発を業務とするエンジニアが、作成したプロダクトや提供する企業の価値を低下させないために、エンジニアリング以外の部分で心がけたいポイントについて紹介します。 個人が趣味で公開しているWebサイトと、企業などが事業として提供するWebサイトでは何が違うのでしょうか？ 一番の違いは、責任の大きさだと思います。個人のサイトに
Google開発者向け文書スタイルガイドの要点 : IT翻訳者Blog
Googleが開発者向け文書で使っていた英語スタイルガイドが社外に公開された（Googleブログ）。 URLはこちら： Google Developer Documentation Style Guide https://developers.google.com/style/ MicrosoftやIBMは自社の英語スタイルガイドを書籍（リンク：MS／IBM）として販売するしているし、Appleは公開（リンク）している。Googleもマテリアル・デザインの一部としてスタイルを公開してはいる（リンク）が、分量が少ないため、他社と比べるとどうしても見劣りした。 そのため、「開発者向け文書」を対象としてはいるものの、ある程度の規模のスタイルガイドが公開されたのは意義深い。 そこで今回は、同スタイルガイドの要点（highlight）のみについて読んでみたい。 Highlights https://
英語でサポートを求める時の Tips - Qiita
私は、サンフランシスコに住んでいたことがあって、インフラの勉強していたのですが、当時勢いで応募したインターンに受かり、その後エンジニアとして働いていました。日本人はもちろん一人で、プリセールスからJava のコーディング、テスト、サポート、ドキュメントまでの一連を日本語にローカライズする仕事をしていたのですが、その時の試行錯誤で（失敗もしくは成功から）学んだことをログしていきたいと思います。 当時はほんといろんな面で初心者・経験なしだったので、当たり前のことを書いていたらすみません、、、 当時のタスクの一つとして、QA がありました。仕様でない動作を見つけたら、バグ管理のシステムに入力し、担当の人に修正してもらい、修正を確認するというものです。 当時英語は問題なくできていたのですが、やはり「説明」となると急にハードルが上がりました。始めは、ほんと何にもQAに関する知識もなかったので、一生懸
今日から使える文章校正テクニック | DevelopersIO
渡辺です。 昨日のエントリーが結構反響大きめだったので、第二弾です。 文章校正をしていてよくあるパターンを幾つか抽出してみました。 ただし、前回紹介しているパターンは除外していますので、あわせて確認ください。 重複を減らす 文章校正の基礎は 重複を減らす ことです。 次の文章を見てみましょう。 AWSを使い慣れている人にとっては簡単な作業ですが、使い慣れていないと戸惑う所も多いところです。 この文章がくどく感じる理由は、「使い慣れている」が重複していることです。 前後関係もありますが「ところ」がなにを指しているのかも曖昧ですね。 後半の「使い慣れている」を削除し、バランスを取るために作業を後ろに移動しました。 さらに、前の文章を受けるため、「これは」を追加します。 これは、AWSを使い慣れている人にとっては簡単ですが、そうでないと戸惑う作業です。 スッキリしました。 しかし、「慣れていると
文章をベクトル化して類似文章の検索 - Qiita
Doc2Vecで類似文章を検索してみたので、実装を紹介します。 Doc2Vecとは コンピュータが自然言語を処理するためには、まず人間の言葉をコンピュータで扱える値にする必要があります。 単語の意味をベクトル化する手法としてWord2Vecが存在します。 詳しくはリンク先がとてもわかりやすいのですが、ざっくり言うと前後n単語のリストでその単語を表現します。 こうすることで、例えば「犬」と「猫」は同じような文脈で使われるため、似た「意味」であると考えることができます。 Doc2VecはWord2Vecを応用し、文章をベクトル化するものです。 実装サンプル 今回Doc2Vecを用いて実現するのは、以下の2つの機能です。 単語で文章を検索 類似文章の検索 サンプルとして、青空文庫の文章を使用しました。 なお、この記事で使用するコードはGitHubで公開しています。 (学習に使用した文章もzipに
【社内資料公開】40歳中堅サポートエンジニアが文章作成時に気をつけている5つのキーワードを紹介します | DevelopersIO
はじめに こんにちは植木和樹＠上越妙高オフィスです。クラスメソッドではAWSを始め、弊社で取り扱っている製品・サービスに関するサポート業務を行っています。 サポートでは日々様々なお問い合わせを受け付けるわけですが、ご質問に対する回答内容は正しくても、言葉が足りないためにお客様が不満に感じてしまうことがあったりします。「正しいことを伝えたのに、どうして不満と感じたんだろう？なにが足りなかったんだろう？」と対応を振り返る際に、私はキーワード／パターン／フレームワークに当てはめてみて考えるようにしています。 今回はサポートメンバーがよりよいサービスが提供できるよう、自分のアンチョコから5つのキーワードをご紹介したいと思います。 1.安心してもらう 自分で書いた回答内容を見返してみましょう。文章の内容がお客様に安心を与えているでしょうか？ 最後に「安心です」がつくように意識しましょう。また「文章の
Elasticsearch、Logstash、Kibana、Kuromojiでタグクラウドを作る - Taste of Tech Topics
突然ですが、我が家は2階にリビングがあるタイプの戸建てでして、天井が勾配していてカッコイイ感がすごいのですが、この季節は暖房の熱がどんどん登ってしまってなかなか部屋が暖まりません。 要するに寒いという話なのですが、皆さんいかがお過ごしでしょうか、@cero_t です。って僕のジョークと家の寒さは関係ないですから💢 さて、このエントリーは Elastic Advent Calendar の18日目です。 qiita.com 元々、マイクロサービスの可視化や、Kafkaを用いたデータ収集の安定化について書くつもりだったのですが、思いつきで作ったタグクラウドが予想外にイイ感じだったので、このエントリーではその経緯を紹介したいと思います。 タグクラウドとは、文中に頻繁に登場するワードを上の絵のように可視化する機能です。 最近リリースされたKibana 5.1.1に新しく追加されました。 この機能
技術系メーリングリストで質問するときのパターン・ランゲージ
目次 はじめに メーリングリスト —— サポートセンターではなく互助会です 表題 —— あいさつではなく用件を書きましょう 自己紹介 —— 自分の知識・技能・経験を簡潔に書きましょう 書き出し —— 最初に問題の要旨を書きましょう 肩書き —— 会社の名前を背負っていることを忘れないように 実行手順 —— 手順は箇条書きで書きましょう 結果の予想 —— 期待した結果を書きましょう 実際の結果 —— 実際に起きたことを書きましょう ステップ明記 —— どこからうまく行かなくなったかを書きましょう 実際の値 —— 条件を具体的に書きましょう エラーメッセージ —— 必ずコピー＆ペーストしましょう 判断理由 —— そのように考えた理由を書きましょう 文献の引用 —— 読者の手間を省くように書きましょう ソース —— 関連する部分を抽出して示しましょう スレッド —— 関連する話題なら「返信」しま
WEBライターが教える「読みやすい文章」を書くためのライティングのコツ | ayan's style
ayan's style > サイトコンテンツ作成 > WEBライターが教える「読みやすい文章」を書くためのライティングのコツ 私はブロガー13年目、最近はWEBライター／旅ライターとしての仕事もしています。 先日、「視点の違いで作り出せるものは変わる！ 新たな視点を獲得する方法」という記事を書きました。読んでいただけるとわかるのですが、書籍のレビューを通常とはちょっと違う切り口で書いた文章となります。 通常は書籍のレビューというと、「○○という本を読みました。その本は…」と、まず本を最初に持ってくると思うのですが、今回はすでにネット上に同じ書籍のレビューがたくさん公開されている状態だったため、最初に本のことを書かず、文章の後半で自然な形に本の内容に触れられる構成を意識しました。 この記事を公開した後、その文章の書き方について、まわりのブロガーさんから以下のようなお言葉をいただきました。
メールでの「お詫び」誠意が伝わる・万能な言い回し文例集
文章を書くのが苦手だ。メールの表現に悩み、時間がかかる。マナーに厳しい取引先がいる……。一般的な書き方を知れば、面倒は減る。今回、ニーズ別に、フレーズと文例を集めた。日本ビジネスメール協会の平野友朗さんと「ビジネス表現の基本」を確認しよう。 難解な表現よりもいつもの言葉で お詫びが必要なときは、つい肩に力が入って、難解な文を書いてしまいがち。肝心の受け手はどう感じるでしょうか。たとえば「陳謝いたします」は最上級のお詫びの言葉ですが、これを22歳の社会人1年生が書くか60歳の経営者が書くかでは、意味合いが変わってきます。「自分は会社を代表している」という認識があるような人を除けば、「ご迷惑をおかけしましたことをお詫び申し上げます」と書くほうがいいでしょう。大切なのは、ふだん使っている語彙のなかから、その場にふさわしい言葉を選び出すということです。 相手が勘違いをしているなど、自分に非はなくて
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Ludwig • Find your English sentence
Web文章入門（全7回） コーナーの記事一覧 | Web担当者Forum
GitHub English Challenge Cheat Sheet - Qiita
次々に読まれる文章とは？ コーナーの記事一覧 | Web担当者Forum
Grammarly: Free Writing Assistant
