textlint

こんにちは、クラウドソリューション部の花岡です。 この記事はオルターブースアドベントカレンダー2023の23日目の記事です。 adventar.org だんだんとクリスマス 🎄 が近づいてきました！ 街はにぎやかお祭り騒ぎでチキンライスが食べたくなる時期です はじめに 今回は文章校正ツールである(textlint)https://textlint.github.io/を使ってAzureのプロダクト名のtypoを検知するルールを作成し公開しました。 AWSのサービス名のtypoを検知できるルールを作ったクラスメソッドさんのブログを見て、Azure版もあれば便利だなと思いOSSで作ってみました。 …

この記事は弁護士ドットコム Advent Calendar 2023の4日目の記事です。 前日は @saku_238 さんの「部屋とTシャツと私 〜Tシャツから2023年を振り返る〜」でした。 こんにちは、弁護士ドットコム本部 デザイナーの細貝です。 一昨年のアドベントカレンダーで、弁護士ドットコムのtextlintのプリセットルールとBotをつくった記事を書きました。 note.com （気づいたらもう2年前なことに震えてしまいますが）いまでも凛さんBotは社内でちょこちょこ活用されています。 プルリクエストを送っていただいたり、ルール追加の相談をいただいたり…と、辞書に載せている用語も少し…

はてブの記事を管理しているgithubに文章校正ツール（textlint）を導入した。

間違えていたので修正版です。textlintを実行して！がエラーになるのはtextlint-rule-preset-ja-technical-writingの設定が原因です。設定項目は感嘆符!！、疑問符?？を使用しないを無効にすれば！や？を使えるようになります。 設定先は.textlintrc.jsonです。これを開いてrulesを以下のようにします。 "rules": { "preset-ja-technical-writing": { "no-exclamation-question-mark": false }, textlintを実行しなおす、あるいはVSCodeの再起動で適用されます…

ブログや職務経歴書など、Markdownで文章を書く際に文章を校正してくれる環境を作成しました。 校正はtextlintで行っています。 VSCode上で動かすことを前提に作っています。 github.com やっていることはtextlintなど、様々な先人たちの知恵をDockerfileなどにまとめて、VSCodeですぐに試せるようにしました、というだけです。 しかし意外なことに、これらをまとめて1つの環境にしている方は意外といなかったので、今回公開することにしました。 もしすでにいたらすいません、その場合は二番煎じです。 できること image VSCode上で文章を書きながら、自動で校正…

こんにちは。アルバイト事業部エンジニアのmnmandahalfです。 私たちは積極的にエンジニアの仲間を募集していますが、もっと私たちの組織・文化・利用技術について知ってもらおうと思いLivesense Engineering Handbookというものを作りました。 *1 Livesense Engineering Handbookについて エンジニア採用資料作成における一般的な課題 課題の解消のために工夫した点 GitBookの採用、Pull Requestでの更新 GitHub Actions + textlintでの校正 定期的なリマインドやアクセスを促す仕組み Join us! Li…

ブログ記事も含めて文章を書くときに使う句読点は ， と ． に統一している．2006年頃から使っているからもう15年以上になる．macOS や Windows をセットアップするときに最初にデフォルト設定を変更するのも「句読点」だったりする．しかし，フォーマットが決められたビジネス文書など，句読点として 、 と 。 を使わなければいけない場面もあるため，文章を書き終えてからエディタで一括置換をするという作業をよくやっている．今回は textlint で句読点をチェックして誤用を検出できるようにする． 例文 今回は以下の例文 hello.txt を使う．特に意味はなくブログ記事用に作る． こんに…

こんにちは！Techouse の人材プラットフォーム事業部でサーバーサイドエンジニアを担当している aki と申します。2024年4月に新卒入社し、現在は事業部内で利用する社内システムの開発を担当しております。 同時に開発者ブログの運営チームにも所属しており、立ち上げ時に基盤構築を担当しました。運用が開始した後も、継続的に運用改善に取り組んでおります。本記事では、Techouse の開発者ブログの運用についてご紹介します。 Techouse の開発者ブログ運用 皆さんの会社では、開発者ブログの運用はされていますでしょうか？Techouse では、2024年の4月に開発者ブログを立ち上げました。…

はじめに ヤプリで新卒SREをやっている眞田です。 ヤプリでは、エンジニアが日々業務を遂行する上で学んだ技術をテックブログに公開しています。 ヤプリのテックブログははてなブログ上で管理されていますが、GitHubなどを利用した運用はされていない状態でした。 そこで、GitHubを利用したブログ投稿までの運用フローを構築しました。 本ブログでは、この決断に至った経緯と運用までのフローについて紹介します。 以前までのブログ管理 これまでヤプリでは、テックブログを投稿するフローは以下のようになっていました。 Web上で下書き作成 → Web上で編集 → Web上で下書きを確認し、レビューする → W…

仕事柄、ブログを書いたり、たまに雑誌の記事を書いたりすることがあります。 Windowsを使っていた時代は一太郎とATOKを使って、書いた文章の文書構成をしていました。 MacではATOKは動きますが、一太郎は動きません*1。その上、今のATOKはサブスクしかないのでバリバリ雑誌の記事を書いているなら元は取れますが、ブログだけだとマイナスが増える一方です。 最近のWordの文章校正機能は昔のそれと比べるとかなり良くなりました。とはいえMarkdown形式で書くことが割と多いので、わざわざWordにコピーして文書構成をしてMarkdownに落とすというのも面倒です*2。 そんなあなたにtextl…

どうも、かたいなかです。 採用広報チームでのブログ推進の一環として、はてなブログにある弊社エンジニアブログ記事をGitHubで管理するしくみを整えました。 この記事では、どのようなGitHubでの記事編集フローを構築したかをまとめます。 記事のレビューのフローがバラバラ・・・ GitHubで記事を管理できるように GitHub Actionsでtextlintを実行 GitHub Actionsではてなブログ側の変更を取り込む 定期実行のワークフローで公開された記事を公開済み記事のディレクトリに移動 GitHubで記事を管理できるようにしてどうだったか 参考 記事のレビューのフローがバラバラ・…

はじめに 気づいたら ブックマークに 載っていた nikkieです。 明日6/7(金)のLint Nightがとても楽しみなので、予習エントリを書きます。 目次 はじめに 目次 Lint Night #3 szkdashさん「lintnet - General purpose linter powered by Jsonnet」 Linda_ppさん「actionlint の Linter 設計」 haya14busaさん「reviewdogについて（仮）」 tomoyamachiさん「パーサを使わないLintツール dockle (仮)」 復習 Lint Night 第1回 第2回 終わりに…

Emacsでtextlintを使うのにかなり苦労したが、動くようになったので、一連をメモしておく。 textlint node.jp まずはnode.jpをインストールした。 https://nodejs.jp/ 作業フォルダ ドットインストールで予習した。 https://dotinstall.com/lessons/basic_textlint ドットインストールに倣って、以下に作業フォルダをセットした。 C:\Users\hogehoge\AppData\Roaming\.emacs.d\MyTextlintProject\ textlint Powershellで上記フォルダにインスト…

こんにちは。Platformチームの飯迫 (@minato128)です。 今回は、Tech Blogの移行について簡単に紹介したいと思います。 背景 キャディのTech Blogでは、これまでKistaのManaged WordPressを利用してきました。 主な採用理由は、「カスタマイズ性の高さ、マネージドで安全に変更を反映できる仕組みがあること」でした。 実際、KinstaとWordPressはカスタマイズ性が高く、他社と差別化されたデザインを採用できたことはよかったのですが、下記のような課題がありました。 記事公開までの手順がシンプルではない*1 Production環境へのデプロイ（記…

マネージド&セキュリティサービス部サービスプラットフォーム部門の田中です。 2023年度の下期にダブルワークという社内施策で、イノベーションセンター生成AIチームに参加しました。 その取り組みとして、本ブログの記事データを管理している GitHub リポジトリに LLM (大規模言語モデル) の1つである GPT-4 を用いた校正CIを導入してみました。 適切なプロンプトを得るための試行錯誤や、この記事自体を校正させてみた結果をお伝えします。 目次 目次 背景 LLM校正CIの詳細 プロンプトの試行錯誤 この記事の校正結果 おわりに 背景 本ブログ記事のデータ管理やレビューには GitHub …

はじめまして、ジョブハウス、クラウドハウスを運営しているTechouseでシニアエンジニアリングマネージャーをしている、西村（nissiy）と申します。 このブログの公開日で入社してちょうど半年になりました。 この度、新年度を迎えたこともあり、心機一転、Techouseでも開発者ブログをスタートすることになりました。 一発目の記事ということで、今回はTechouseがなぜ開発者ブログをスタートするに至ったのか、このブログを通じて何を成し遂げたいか、運用体制はどうなっているのかをご紹介していきます。 まだスタートしたばかりではあるので、今後どうなっていくのか見えないものばかりではありますが、三日…

2024/3/2 https://jawsdays2024.jaws-ug.jp/ AWSからはここ数年離れてたので知らない話ばかりでした IaC周り、データ連携周り、セキュリティ周りが知らないことが多くて聞いてて面白かった 今はAWSは使ってないけど、使うとしたら話に出てきたこれを使うのかなとか思いながら聞けました Keynote Jeff Barr ユーザコミュニティの話 日本のユーザコミュニティは10年以上続いてる 土曜日に自発的に参加しようと思う人が1000人いるだけですごい スピーカーになれる人をもっと増やしていくと良い 新しい人を受け入れていくために初心者向けのコンテンツも大事 ぼ…

初めに 初めまして、「教育学習サービス『N予備校』サーバーサイドエンジニアインターンシップ」に参加した落合大輔です。 私は大学院の修士1年生の秋頃にインターンシップに応募しました。内容はTypeScriptによるバックエンドの開発です。私の場合は期間は4ヶ月程で1週間あたり16時間程のシフトです。 参加をおすすめする人 ドワンゴのインターンシップは下記の様な人にお勧めです。特に「ものづくりが好き」という人にお勧めです。 ものづくりや技術が好きな人 自分の手でコーディングを行い開発がしたい人 チーム開発のノウハウを学びたい人 開発環境 ドワンゴのインターンシップでは各自にPCが支給されます。OS…