知識や技術をドキュメント化する必要性

長田 太彪のプロフィール画像
エンジニア 長田 太彪

894 view

私はエンジニアとして、今までと異なる技術や設計などを試し知見を得ること、過去のコードをブラシュアップすることなどでスキルアップすることが必要だと考えており、これはエンジニアである以上ずっとそうありたいが、一方でこれまで培ってきた技術をドキュメント化する必要性も感じている。

これまで弊社に入社したエンジニアの傾向を見ると、HTML、CSS、JavaScript(jQuery)は書けるが、弊社で使用する開発環境(Git、タスクランナー)への理解不足や、実装面での独自ルール、例えばFLOCSSベースのCSS設計や、JavaScriptの設計に馴染むのが難しい、大規模サイトに対応するのが難しい、ということが多い。

これは新人エンジニアなら必ず通る道であり、後半に至っては社内文化なのでエンジニアのレベル関係なく発生する。ただ、教える側にとっては毎回説明するのはかなり骨が折れるし、異文化になじむ側も人によって説明が違うと、その人の理解度や教え方によって言われることが違うという状況にも成りかねず、体系だって学べないと結構つらい。できればこのあたりは毎回説明せずとも勝手に学べる環境を用意して、それよりもJavaScript、PHPの難易度の高い実装などに注力できたほうがよい。

以前コーディングテンプレートを作成していたが、HTML,CSSレベルであれば1から学ぶよりもテンプレートを使った方が早いし、例えば「こういう形のコンポーネントにはこういう名前を付ける」という命名ルール、「こういう考えだから余白はここにつける」というスタイルの指定ルールなどの社内文化を学ぶ学習コンテンツにもなるはずだ。

またそれとは別にgitやpug、sassなどを社内でどうやって使っているか、というドキュメントもあった方がよいだろう。プログラミング経験者であれば「公式ドキュメントを見て」だけで良いかもしれないが、それだけでは皆が十分に理解できるか怪しい。そしてその中には社内で使わない技術も多く、弊社で役立つスキルを身に付けるという意味では無駄が多い。なので、社内で使う技術だけでも先に身に着けてもらった方が良い。

エンジニアの採用に力を入れるのも勿論だが、一方で入社してくれた方が学びやすい環境の整備も力を入れていきたい。

関連する日報

    自分の「弱さ」を武器にする仕事術

    136 view

    西岡 紀子のプロフィール画像
    西岡 紀子 コンテンツディレクター
    「物知らん奴の企画、おもしろくないやろ」を言い続けている

    1,519 view

    荒川翔太のプロフィール画像
    荒川翔太 採用コンサルタント
    ホスピタリティの本質は、観察力にある

    320 view

    廣瀬 弥礼のプロフィール画像
    廣瀬 弥礼 プロジェクトマネージャー
    ミーティングはゴールから始めよ

    1,204 view

    早見真由のプロフィール画像
    早見真由 プロジェクトマネージャー
    「完全移行」はなぜ伝わらなかったのか

    310 view

    野村 輝のプロフィール画像
    野村 輝 情報システム
上に戻る