はてなブックマーク

この記事はSmartHR Advent Calendar 2021 15日目の記事です。 こんにちは、@kgsiです。久しぶりの技術記事です。 今回は小ネタとして、コンポーネントライブラリのPropsをすべてJsonに出力することで幸せになるための方法を書きました。 何でやるのか？ 所属している会社ではSmartHR UIという、React製コンポーネントライブラリがプロダクトで活発に利用され、それ故にリリースサイクルも速く、毎週一回のペースで更新されています。 他方、SmartHR UIの使い方やPropsを定義する場所としてSmartHR Design Systemという、デザインに関わるドキュメントを包括管理しているガイドラインが用意されています。棲み分けと役割を明確に分けており、両者は別々のリポジトリで管理されている状態です。 さて、そんなコンポーネントライブラリとドキュメントシス

筆者の職能は主にWebサービスのデザイン、エンジニアリング業務ですが、それをそのまま副業に活かしてます。振り返ってここ1年、副業の機会を多くもらっているので、「そういえば副業をするにあたって何を考えて、どんな資料をまとめてるんだっけ？」を、ナレッジ共有の意味を込めてドキュメント化してみました。 対象読者 これから副業を始めてみたいと考えてる開発・制作関係の方 そもそも副業の肌感がわからない方 何故副業をやるのか？ まず何事もそうですが、副業を受ける上でも目的、または目標を持ってみましょう。例を挙げてみると、以下のようなことでしょうか。 本職で携われない技術分野を磨きたい お試しで携わって、気に入ったら転職したい 直近まとまったお金が欲しい etc.. 「何故やるか」を明確にすることで、具体的にどうアクションするべきかをハッキリさせます。また、目的に沿っている仕事かどうかを判断するための材料

会社でtextlintを使った文書校正の仕組みを開発していますが、他社事例を調べてみたかったので、公開されているルールや事例をまとめてみました。他にあれば随時追加していきます。 企業別公開ルールプリセット 公式に公開されているルールは少なめ。 弁護士ドットコム ICS WEB+DB PRESS 企業からの直接発信ではないが紹介。prh-rule形式で提供されている。 SmartHR 企業での利用例 board boardのヘルプは、Githubで管理し、プルリクエストを使って編集・校正を行っています。 GMOペパボ ・表記ルール『Pepabo Writing Style Guide』 ・自動校正チェックツール『Kindaichi Check Tool』 ・用語集『Kindaichi DB』 社内ツールKindaichi Suiteの文書校正ツールはtextlintベースで作られているようで