こんにちは。トラストバンク　パブリテック事業部　プロダクトグループのみきです。 自治体職員専用ビジネスチャットの「LoGoチャット」をメインに、複数の自社プロダクトをサポートしています。 LoGoチャット上でお問合せ対応をする中で、分かりやすい文章作成技術を学びたいと思うようになりました。 そこで今回は、書籍を通して学んだ「テクニカルライティング」について、紹介します。 テクニカルライティングとは テクニカルライティングのポイント 1. 一文一義で書く 2. 一文50文字程度で書く 3. 結論から書く テクニカルライティングの活用シーン 1. 社内のコミュニケーション 2. ユーザーマニュアルの作成 「読み手」と「目的」を想定する 読み手の目的別に、マニュアルを構成する 「参考情報」や「注意文」など、情報の要素を分けて書く 3. 障害報告書の作成 分かりやすく書く 主担当者以外にも伝わるよ

このコーナーでは、2014年から先端テクノロジーの研究を論文単位で記事にしているWebメディア「Seamless」（シームレス）を主宰する山下裕毅氏が執筆。通常は新規性の高い科学論文を解説しているが、ここでは番外編として“ちょっと昔”に発表された個性的な科学論文を取り上げる。 X： ＠shiropen2 英レスター大学などに所属する研究者らが2019年に発表した論文「Comparative Relevance of Physical Fitness and Adiposity on Life Expectancy」は、身体能力と肥満度が平均寿命にどのように影響するのかを詳しく調査した研究報告である。特に注目したのは、自己申告による歩行ペースと握力計で測定した握力という2つの身体能力指標である。 実験は2006～2016年にかけて行われ、47万4919人という大規模な参加者を対象とした。参加

React 19 is now stable! Additions since this post was originally shared with the React 19 RC in April: Pre-warming for suspended trees: see Improvements to Suspense. React DOM static APIs: see New React DOM Static APIs. The date for this post has been update to reflect the stable release date. In our React 19 Upgrade Guide, we shared step-by-step instructions for upgrading your app to React 19. In

Slackで「質問があります。詳細はスレッドに記載」をやめたほうがいい理由 この記事はCARTA TECH BLOGアドベントカレンダー12/2の記事です。 こんにちは。CARTA MARKETING FIRM でエンジニアをしている 前田@brtriver です。アドベントカレンダーということで、ちょうど最近社内のブログに書いた記事を、社内に限らずテキストコミュニケーションツールを使っている会社では似たようなことが起きているのではないかということで、軽くリライトしてアドベントカレンダーの記事にしたいと思います。 要件書かない「詳細はスレッドに記載」はパブリックに情報を共有する手段としてはイマイチ Slackで「質問があります。詳細はスレッドに記載します」と書いて、スレッドに詳細を書くコミュニケーションを見かけることがあります。こんな感じですね 要件があることだけを短く伝えて、詳細をスレッ

少しの工夫でゲームの安っぽさを解消する手段のご紹介！第二弾！ 前回の以下の記事が過去最高に好評を頂いたので続編です。 今回もちょっとした手間で、クオリティアップを目指していきましょう！ この記事はゲーム制作者の発表の場アドベントカレンダーに参加中です。 https://adventar.org/calendars/10489 ■安っぽさが起こす悲劇・安っぽいからきっと中身も…さよならゲームは目に留まった時に「安っぽい」という印象を与えてしまうと、中身も大したことないんだろうな…と思われ、そこで人は去っていってしまいます。 やれば面白い。でも…手に取ってもらえない。わかります。 そういったゲームはこの世にたくさんあります。 そういったゲームを救いたい。 貴方のゲームが一人でも多くの人に手に取ってもらえるように、クオリティを上げていくぞ！という応援記事です。 ※自分の専門分野じゃない箇所を、手

クリエイティブ系のウェブサイト制作で役立つCSS技法 / CSS for develop creative website

ポリシー: この世界では常に最新版を使うという気持ちで生きていく Node.js は枯れるという概念がなく、常に古いことはリスク という認識。LTS も短め(3年) 古いAPIのドキュメントは常に消失する モダンなツールは、モダンな前提を要求する ~2020: CJS/ESM 関連で断絶がある(jestが動かなくなりつつある) ~2019: パフォーマンス意識が低い時代の実装が多い ~2015: Node.js のみでしか動かないものが多い。peerDeps の意識が低い この辺で目視でポチポチする npm: npm-check-updates - npm yarn upgrade-iteractive pnpm upgrade -i サーバーランタイムには安定を、ツールチェインにはパフォーマンスを サーバーランタイム(Node.js) Node 本体は Stable LTS か、一つ前の

単なる自分のやらかしの共有です。この記事は事実をもとにしたフィクションです。 消し忘れたclose()関数 あるときモーダルコンポーネントを閉じる、close()関数というのを作りました。後日、リファクタリングをするときこの呼び出されているclose()関数がとあるコンポーネントから取り除かれることになりました。しかし誤って1つ削除し忘れてしまい、close()関数が取り残されてしまいます。 このとき、import文なども取り除かれたのですが、何故か未定義エラーなどは出ずに見過ごされてしまいました。（察しの良い人はピンとくるかも） 何故か消えるウィンドウ そんな中、消し忘れたコンポーネントを含む画面で特定の手順を踏むと開いたブラウザウィンドウが閉じてしまう現象が確認されるようになりました。 どうやら発生源は先程のリファクタリング作業らしい… window.closeというJavaScrip

'Programming Languages That Blew My Mind'というブログ記事で、8歳からプログラマーとして活動しているDavid Tellerさんが、人生で出会った革新的なプログラミング言語について紹介している。 BASIC A language designed to make programming simple. Mind blown: Programming my own games! Mind blown: Arrays (or DIM, as they were called)! Mind blown: GOTO! Mind blown: GOSUB! Original, line-based, Basic is dead, but its legacy lives on in VB.Net, VBA, but also in more subtle ma

プログラミングでは、1文字でも打ち間違いがあればエラーの原因になってしまいます。 そこで似たような文字、例えば数字の「1」（いち）とアルファベットの「l」（エル）、数字の「0」（ゼロ）とアルファベットの「O」（オー）などを容易に見分けられるようなフォントを使うことが、ミスを防ぐことにつながります。 コードを表示させたときに整然として見やすく、エディタ上でカーソルを上下に移動させてもカーソル位置が左右にぶれずに表示されるように文字の幅が等幅に揃っていることも必要でしょう。 日本語の場合には、「－」（マイナス記号）と「ー」（音引き）の区別や、コード内に全角空白が紛れ込んだとしてもすぐに見分けられることなどの特徴を備えていることもプログラミングに適したフォントに求められる条件だといえます。 この記事では、そうした特徴を備えたプログラミングに適したフォントをまとめました。 ここで紹介されていない日

M4 MacBook Pro発表。M4 Max、バケモノです2024.10.31 00:40142,751 小暮ひさのり プロ納得のモンスター、爆誕。 連日のApple（アップル）新製品祭り。iMac、Mac miniと続いて本命？ とも言えるMacBook Pro、M4チップを搭載して堂々のリニューアルでございます。 Image: Apple今回のアップデートでは、基本的なボディデザインの変更はなし（カラーはスペースグレイ→スペースブラックへ変更）ですが、チップは最新のM4シリーズへと刷新。高性能なM4 Pro、さらに上を行くM4 Maxまで選べるようになっています。 Image: Apple参考までにM1世代と比べると、M4は約3倍〜3.5倍の処理性能であるとのこと。 しかもバッテリー持ちはM4モデルがもっとも長く最大24時間！ M4 Proは最大22時間、M4 Maxは最大18時間と

We’re excited to announce a change in our licensing model that we believe will benefit the developer community – WebStorm and Rider are now free for non-commercial use! Read on to learn more about the change and why we’re making it, and be sure to check out the FAQ section below for additional details. What’s happening? Earlier this year, we implemented a new licensing model for our recently intro

参考 IT業界では、請負契約と準委任契約がよく使われます。 委任契約はあまり使われることはなく、筆者も見たことがありません。 これは、エンジニアが法律行為を伴う業務を行うことが少ないためです。 請負契約と準委任契約の違い 請負契約と準委任契約は、どちらも業務委託契約の一種ですが、大きな違いがあります。 一言でいうと、請負契約は「成果物を納品することが目的」であり、準委任契約は「業務の遂行自体が目的」です。 請負契約では成果物を納品する責任が発生しますが、準委任契約ではその責任は発生しません。 ウォーターフォール開発で言うと、PoCや要件定義は準委任契約、設計や開発、テストは請負契約になることが多いです。 また、SES（システムエンジニアリングサービス）も準委任契約で結ばれることが多いですね。 PoCや要件定義が準委任契約になることが多いのは、不確定要素が多いため、確実に成果物を納品すること

Refactoring UIで公開された「Labels are last resort」より許可をもらい、日本語抄訳しています。 ユーザーにデータを表示するとき（特にベータベースから読み込むとき）、一般的なlabelプロパティを使って表示するという罠に陥りがちです。 すべてにラベルを利用した悪い例？ このアプローチの問題点は、データをなにかしらの階層構造で表示することが難しくなること。どのデータも等しく重視されるようになります。 ラベルはまったく必要ないかもしれない 多くの場合、書式を見るだけで、そのデータが何であるか直感的に理解できます。 たとえば、nanas[email protected]はメールアドレス、(619)765-4321は電話番号、￥980は価格といった具合です。 フォーマット形式が分かりにくいときは、コンテンツにすでに含まれていることもよくあります。たとえば、従業員名簿で誰か

I've hired a lot of developers over the years. More than a few of them have come in with a strong belief that our code needed heavy refactoring. But here's the thing: in almost every case, their newly refactored code was found by the other developers to be harder to understand and maintain. It also was generally slower and buggier too. Now, don't get me wrong. Refactoring isn't inherently bad. It'

WebKitのcommitterになった。僕はAppleやIgaliaやSonyの従業員ではなく、完全に趣味である。 I'm officially a WebKit (@webkit) committer! Thank you to the JSC reviewers who have been reviewing my patches. — sosuke (@__sosukesuzuki) August 18, 2024 WebKitの開発者のステータスのポリシーは https://webkit.org/commit-and-review-policy/ を参照してほしい。Committerよりも強い権限を持つreviewerという人たちもいる。人のパッチを正式に承認したり拒否したりすることはreviewerにしか出来ない。 2024年2月からパッチを投げ始めて、6月の半ばくらいにcom

この記事は、静的解析とビルドサイズ面で興味深いテーマでした。記事として自分の考えを書きます。 注意。あくまでビルドパフォーマンス視点での最適化です。強い意図があって、自分のドメインモデリングの方法論ではこれが最適なんだ、というなら元コードの方法論を止めるつもりはありません。 元記事のコードを minify するとどうなるか 元コードを参考に、それにアクセスするサンプルコードを書いてみます。 const sortingOptions = { priceDesc: { id: "priceDesc", sort: "price", order: "desc", label: "価格が高い順", }, priceAsc: { id: "priceAsc", sort: "price", order: "asc", label: "価格が安い順", }, ratingDesc: { id: "ra

2022年、ロシアとドイツを結ぶ海底の天然ガスパイプライン、ノルドストリームで起きた爆発について、ドイツの複数のメディアは、ウクライナ人の男が関与していたとして、検察当局が逮捕状を取ったと伝えました。ただ、この人物がウクライナの軍や情報機関とつながりがあったかどうかは、明らかになっていないとしています。 ロシアからバルト海を経由して、ドイツなどヨーロッパに天然ガスを送るノルドストリームで、2022年9月に爆発が起き、欧米メディアはこれまでに、ウクライナの特殊部隊が関与して、ロシアの資金源を断つために行った可能性などを報じてきました。 こうした中、ドイツの公共放送ARDなど複数のメディアは14日に、ウクライナ人の男が爆発に関与していたとして、検察当局が逮捕状を取ったと一斉に伝えました。 それによりますと、男は、ウクライナのダイビングスクールでインストラクターとして働いていた経歴があり、その後