2024年6月10日のブックマーク (2件)

  • サンプルコードのガイドライン - MDN Web Docs プロジェクト | MDN

    この記事で記述するガイドラインは、言語に関係なく、サンプルコードのスタイルと形式に適用されます。サンプルコードを書くときにどのような内容を入れるべきかについてのガイドラインは、執筆スタイルガイド を参照してください。 技術別のガイドラインについては、以下の記事を参照してください。 HTML のガイドライン CSS のガイドライン JavaScript のガイドライン シェルプロンプトのガイドライン この部分は、特定の機能や特徴の使い方を示す、理解しやすい最小限のサンプルコードを作成するための一般的な最善の慣習を提供するものです。 サンプルコードの要件は次のようなものです。 理解できる程度にシンプルでありながら 興味あることを使用するのに十分な複雑さ、そして、できれば有用であること。 全体的に言える 1 つの考慮事項を心に留めておく必要があります。読者はサンプルコードをコピーして自分のコード

    サンプルコードのガイドライン - MDN Web Docs プロジェクト | MDN
    nowrika
    nowrika 2024/06/10
  • Gitでコード管理する際の運用ガイドライン - Qiita

    はじめに データサイエンティストのasanoです。 Gitコマンドを学んだあと「Gitランチ戦略」や「綺麗なコミット」や「プルリクの出し方」など、チームでGitのコード管理を円滑に運用するためのノウハウは実務を通して学ぶことが多いと思います。 実際の業務ではそういった暗黙知になっている部分を認識合わせするために、記事のようなガイドラインを利用しています。 ※ これを読んでスキルが一朝一夕で身に着くわけではなく少ない時間でも毎日Gitを触る中で身につけるものだと思いますが、学習の一助になれば幸いです。 円滑に運用するために 次の3つをチーム全員で取り組む必要があります。 ①Git運用モデルを取り入れる ②綺麗なコミットを心がける ③適切なプルリクを出す、受ける ①Git運用モデルを取り入れる まずはA successful git branch model (git-flow)を学びまし

    Gitでコード管理する際の運用ガイドライン - Qiita