<h2 id="h8d027c8ed3">はじめに</h2><p>私自身が出来ているのかわかりませんが、個人的に気をつけている議事録のポイントを共有します。<br>議事録とはそもそも「何のために」とる必要があるのでしょうか。自分のメモを共有するのではだめなのでしょうか。<br></p><h2 id="ha53ecb0c17">議事録とメモの違い</h2><p>まず、議事録と会議のメモは異なります。<br>「メモ」は自分自身の忘備録として活用するものだと思います。<br>そのため、例えば走り書きでも単語の羅列でも「自分がそのメモを見て思い出せれば」メモをとる目的を果たせます。<br>ですが、議事録はそうではありません。<br>議事録をとる目的として多くを占めるものが「会議での決定事項を明確にし、関係者に共有すること」ではないしょうか（目的は他にもあります）。<br>そしてその「関係者」全員が、会議に参加しているとは限りません。<br>つまり、「自分だけのためにとればいい」メモとは異なり、「会議に参加していない人でも、その会議での決定事項が分かるように議事録を書く」必要があります。<br>このため、議事録がメモ書きになってしまっていては、議事録の目的を果たせないのです。<br></p><h2 id="h6775ed16a1">３つのポイント</h2><p>……と尤もらしいことを書いてしまったのですが、具体的にどうすれば「会議に参加していない人でも、その会議での決定事項が分かるように議事録を書く」ことができるのか分からないですよね。<br>個人的に気をつけている大きなポイントとしては以下のとおりです。<br></p><h3 id="h5c2e2a1036">①決定事項とその趣旨を簡潔に記載する</h3><p>決定事項だけでなく、その趣旨（なぜそうするのか）を記載することで、会議内容がより具体化されます。<br>ただ、決定事項までの流れをつらつらと書いてしまうと、議事録を読んでいる途中で「結局どうなったのか」が伝わりづらくなってしまいます。そのため、決定した事項と「なぜそれが必要なのか」を簡潔に書きます。<br></p><h3 id="hcf032c9c47">②体言止めにせず、動詞まで記載する</h3><p>体言止めで記載してしまうと、具体的に何を行うのか（何が起こっているのか）が不明瞭になってしまいます。そのため、動詞を用いてより具体的に記述します。<br>例）「〜でコストの低下」→「コストが下がった」のか「コストが下がっている」のか「コストを下げる」なのかが分からない</p><h3 id="h2971335a80"><br>③今後のアクションとして、「誰が」と「何を」をセットで記載する（必要あれば「いつまでに」）</h3><p>「誰が行うのか」という「そのアクションの責任が誰にあるのか」を明確にします。責任を明確にすることで、後々問題が発生したときにも役立ちます。<br>ひとまずこの３つを抑えておくといいんじゃないかなと思います。<br></p><h2 id="h9be0c3393d">おわりに</h2><p>「議事録」っていうと難しい気もしちゃいますが、要は「誰が見ても会議内容が分かる記録」なんですよね。<br>議事録を取ることで会議の理解度を深められたり、「相手に伝わりやすい文章」と「要約する力」を身につけられると思うので、私も引き続きがんばります。</p>

議事録をとる上で心がけているポイント

<p>フロントエンジニアの山村です。<br><br>コーディングの中では「HTMLタグで囲みたい」ことや「ダブルクォーテーションからシングルクォーテーションにしたい」など、囲み文字を操作したくなる場面は多いです。<br>この記事では、囲み文字の編集に便利なVimのプラグインである<a style="background-color:#ffffff" href="https://github.com/tpope/vim-surround" target="_blank" rel="noopener noreferrer">Surround.vim</a>を紹介します。<br></p><h3 id="h4277ca4f21">Surround.vimについて</h3><p>このプラグインをインストールすると、<code>cs</code>  (囲み文字の変更) や <code>ds</code>  (囲み文字の削除) といったオペレータが有効になります。<br>通常、囲み文字を修正するにはカーソルの移動が伴いますが、これらのコマンドを使うことでオブジェクトに対してビシッと囲み文字を指定できます！<br></p><h3 id="hdc92f8effb">便利な使い方</h3><p>JSONファイルをつくるときに、プロパティ名と値をダブルクォーテーションで囲みたいとします。<code>ysiw"</code>  でワードをダブルクォーテーションで囲めるため、ドットリピートと組み合わせて効率的な編集ができます。<br>※ リピート可能にするには<a style="background-color:#ffffff" href="https://github.com/tpope/vim-repeat" target="_blank" rel="noopener noreferrer">repea.vim</a>プラグインをインストールする必要があります。<br><br><img src="https://images.microcms-assets.io/assets/98f41c713ae240acbf11bfbf0993ea22/a2fd6835105b42f5b680b2b6e2f6cb24/surroundvim_1.gif" alt=""><br><br>続いて、URLをMarkdownのリンクに編集する方法です。<code>ysiW]</code>  でテキストを丸括弧で囲めるため、無駄な移動なくURLをリンクに変更することができます。<br><br><img src="https://images.microcms-assets.io/assets/98f41c713ae240acbf11bfbf0993ea22/086924d227334f6aafd3e1a57a7b78b4/surroundvim_2.gif" alt=""><br><br>まだ、使いこなせていませんがコーディングの効率が上がるのでおすすめです 👍<br></p>

Surround.vimでテキスト編集を効率化する

<p>最近はコーディング時にキーボード操作を考慮できるよう、普段からキーボードでWebサイトの操作を行うようにしている。<br><br>先日遭遇したサイトでは、ハンバーガーメニュー展開時、展開メニューの最後の項目まで到達したあとにTabキーを押すと、ハンバーガーメニューが自動で閉じられるメニューが設置されていた。<br>個人的に、このハンバーガーメニューはシンプルに「使いやすい」と感じた。<br>というのも、通常、必要のないハンバーガーメニューを「閉じる」ためには、「閉じる」ボタンまで戻るなど、何かしらの動作を行わなければいけない。<br>しかし、遭遇したサイトは閲覧を続ける流れでハンバーガーメニューが自然と閉じられる。<br><br>だが、JISアクセシビリティ達成基準を確認したところ、下記のような基準が設けられていた。</p><blockquote>フォーカスを受け取ったときにイベントを起動することのできるすべてのコンポーネントは、コンテキストを変化させてはならない。</blockquote><p><strong>フォーカス時：</strong>達成基準 3.2.1 を理解する（<a href="https://waic.jp/translations/UNDERSTANDING-WCAG20/consistent-behavior-receive-focus.html%EF%BC%89" target="_blank" rel="noopener noreferrer">https://waic.jp/translations/UNDERSTANDING-WCAG20/consistent-behavior-receive-focus.html）</a><br><br>確かに、展開メニューの最後の項目まで到達したあとにTabキーを押すとメニューが閉じられる仕様は、フォーカス時にコンテキストを変化させることになり、ユーザーの予測できない動きとなってしまう。<br>そのため、ある状況に置いては使用しづらさを感じる可能性があるかもしれない。<br><br>この時思うことが、「自動的に」変化を起こすものは「便利」だと捉えてしまいがちだが、「誰もが」「どの環境でも」使いやすいものを考えたときは「己の意思で操作できるかどうか」「意図した操作ができるかどうか」を念頭に置いて考える必要がある。<br><br>「Escキーで閉じる」に加え、展開メニュー時はフォーカスをメニュー内に閉じ込め、展開メニューの最後の項目まで到達後は「閉じる」ボタンにフォーカスさせるのが一番良さそう。</p>

ハンバーガーメニューのキーボード操作について

<p>パンくずが複数行になった場合の処理について、サイトに合った処理方法を提案できたら良いです。<br><br>パンくずは現在地表示なので、複雑なデザインパターンがいくつもあるというわけではありません。<br>ただ、SP表示やタイトル表示が長くなった場合に、コンテンツ枠からはみ出したものを「どう処理するのか」を考える必要があります。<br>ブラウザ幅からはみ出したものを</p><ul><li>スクロールで表示させるのか</li><li>はみ出した部分を省略させるのか</li><li>複数行にするのか</li></ul><p>など、処理方法はいくつか考えられます。<br><br>たとえば、サイト内の構造が複雑なECサイトであれば、<br>・階層が深くなること<br>・ECサイトという性質上、商品名がフルで表示されたほうが、ページを認識しやすくなること<br>などから、テキスト省略はさせずに横スクロール対応で実装したほうが、ユーザーにとってもわかりやすいと思います。<br>反面、階層が深くなく、長いテキストが表示される可能性が少ない場合は省略してしまったほうがすっきりと見やすくなるかもしれません。<br><br>このように、パンくずに限らず「なぜそうしたのか」を常に説明できる状態にする、ということはとても大切なことだと思います。<br>もしかしたらもっと良い考え方があるのかもしれませんが、このような些細なパターンも提案し、少しでもよいサイトに近づけたら嬉しです</p>

意外と考えるパンくずの処理方法

<p>FLATに入社して初めて「相互レビュー」を導入した際に感じたメリットやより効果を上げるために実践してみたことを書いてみます。<br></p><h2 id="hdda799b038">導入（相互レビューで享受できるメリット）</h2><p>弊社では開発者同士で相互にレビューを行っています。これはスキルセットに関わらず、もれなく案件に携わるエンジニア全員が対象(レビュアーとしてもレビュイーとしても)です！<br>最終的なクオリティチェックの前に開発者同士でレビューし合うことによって、以下のようなメリットが考えられます。</p><ol><li>次工程へ進むコードの質が高められる</li><li>他の人の書いたコードを読むことで、新しい知見を得られる</li><li>最終チェックを行う人の負担を減らせる</li></ol><p><br></p><h3 id="h7218860a29">1.次工程へ進むコードの質が高められる</h3><p>以下のような内容は開発者同士でも確認することができます。<br></p><ul><li>仕様に対するロジックがおかしくないか</li><li>冗長な書き方をしていないか</li><li>わかりずらい命名をしていないか</li><li>(リファクタリングしているのであれば)修正前後でロジックに変化がないか</li><li>変数やメソッドなど、共通化できる部分はないか</li><li>シンタックスエラー、コンソールエラーはないか</li></ul><p><br></p><h3 id="h6fa6ae3a55">2.他の人の書いたコードを読むことで得られるものがある</h3><p>また、これはスキルセットが似通った開発者であっても、そうでなくてもメリットがあります。<br></p><h4 id="hb351c9984c">スキルセットが同じ場合</h4><ul><li>自分では書かないようなコーディング方法、ロジック、命名などがたくさん見れる</li><li>「こう書いたらもっと良いのでは」などのような議論がソースコードを使ってできる</li></ul><p><br></p><h4 id="h11f853a161">スキルセットが異なる場合</h4><ul><li>自分では書けないコードを読む機会がもらえる (新しい発想・共通化の仕方・知らなかったライブラリ等)</li><li>先輩が後輩にソースコードを見てアドバイスする経験を得られる</li></ul><p><br><span style="color:#000000">また、レビューする視点だと間違ったことは言えないのでしっかり調べたり、</span><br><span style="color:#000000">人にFBすることで自戒することにもなるのでかなり勉強になります。</span><br></p><h3 id="h5c25173b95">3.最終チェックを行う人の負担を減らせる</h3><p>単純に開発者同士でレビューを挟むことでクオリティが上がるので、最終チェック時の戻りが減ります。<br>また、過去に指摘された内容を開発者同士で共有することで、同じ指摘を防ぐことなどもできます。<br></p><h2 id="h6418494177"><br>相互レビューの効果をより上げるために実践していること</h2><p><br></p><h3 id="h5c073b1878">1. レビューで指摘された（した）内容を全てTipsとして共有する</h3><p>毎案件終わる度にNotionにTipsとしてナレッジを蓄積しています。<br>内容としては以下のようなものです。</p><ul><li>レビュワー視点で学んだとこ</li><li>レビュイー視点で学んだとこ</li><li>お互いの指摘事項</li><li>お互いが見落としてしまったこと</li><li>ソースコードで議論したこと</li></ul><p><br><img src="https://images.microcms-assets.io/assets/98f41c713ae240acbf11bfbf0993ea22/eafd2e9e3f0f4e56959d7c5855f82d36/%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%202023-06-20%2014.03.55.png" alt=""><br>誰でも見れる場所にナレッジとして蓄積することで同じ悩みを解決したり、同じ指摘を受ける確率を減らせればと思っています。<br></p><h3 id="h02c9839586">2. 良いコードを褒める</h3><p>人は誰しも褒められるとやる気が上がる（？）と思います。（少なくとも自分は）<br>ですので、良いコードを見つけたときは「この書き方めちゃめちゃ良いですね！次から真似します」といった具合にコメントをするように心がけています。<br>お互いに指摘し合うだけではなく、議論したり、良い部分は褒め合ったりしながら開発していくことで仕事が楽しくなります。<br></p><h2 id="ha214098e44">まとめ</h2><p>相互レビューはさまざまなメリットがありますが、開発者同士の協力が必要なため互いのスケジュールが合わない場合もあります。<br>そのため作業がスタックしないようにタスクや進捗の管理には気をつけていきたいです。<br></p>

カテゴリー

人気記事

議事録をとる上で心がけているポイント

Surround.vimでテキスト編集を効率化する

ハンバーガーメニューのキーボード操作について

意外と考えるパンくずの処理方法

エンジニアの相互レビューで感じたメリット

山村の日報一覧

山村

Surround.vimでテキスト編集を効率化する

議事録をとる上で心がけているポイント

Surround.vimでテキスト編集を効率化する

ハンバーガーメニューのキーボード操作について

意外と考えるパンくずの処理方法

エンジニアの相互レビューで感じたメリット