リリースノート管理術
みなさま、OSSの変更履歴、要するにCHANGELOGやリリースノートはどのように管理しておられるでしょうか。自分はというと、抱えるリポジトリも数百個に増えてきて、まあ要するに細かく管理するのがだるく、最近は変更履歴の管理方法も変わってきました。 CHANGELOGからGitHub Releasesへ 昔は、おおよそKeep a changelogの方式に準拠したCHANGELOG.mdを書いていました。semantic versioningでバージョン管理をしながら、個々のバージョンごとに次のセクションを設けて変更内容を説明するような感じです。 Added Changed Deprecated Fixed Removed Security 今は、新規につくるリポジトリではCHANGELOG.mdは用意せず、GitHub ReleasesにKeep a changelogに似た形式で変更内
変更履歴を記録する
Version 1.1.0 # Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ### Added - v1.1 Brazilian Portuguese translation. - v1.1 German Translation - v1.1 Spanish translation. - v1.1 Italian
こんにちは。 ファインディ株式会社でテックリードマネージャーをやらせてもらっている戸田です。 現在のソフトウェア開発の世界は、生成AIの登場により大きな転換点を迎えています。 GitHub Copilot や Claude Code など、生成AIを活用した開発支援ツールが次々と登場し、日常的なワークフローに組み込まれつつあります。 そんな中で先日、Claudeの新機能であるAgent Skillsが公開されました。 そこで今回は、Agent Skillsの紹介と解説、スキルの作り方を紹介したいと思います。 それでは見ていきましょう！ Agent Skillsとは 作り方 ファイル構成 skill-creator 実践編 まとめ Agent Skillsとは Agent SkillsはClaudeの機能を用途や状況に応じて柔軟に拡張できる便利な機能となっています。 docs.claude.
こんにちは。 Findy で Tech Lead をやらせてもらってる戸田です。 このテックブログでは開発生産性を向上させるための取り組みや、開発テクニックを紹介してきました。 意外に思われるかもしれませんが、弊社では全てのことを100％でやってるわけではなく、ユーザーへの価値提供を最優先するために後回しにしている部分もあります。 しかし、その影響で障害が多発したり、困ったことになることは滅多にありません。 そこで今回は、ユーザーへの価値提供を最優先するために弊社で実践していることを紹介していこうと思います。 それでは見ていきましょう！ 綺麗なコードは後。アプリケーションの振る舞いが先。 コミットの粒度は不問。Pull requestの粒度は維持。 実装途中のコードでもマージOK まとめ 綺麗なコードは後。アプリケーションの振る舞いが先。 Pull requestをレビューする中で、「もっ
Goodbye to the C++ Implementation of Zig ⚡ Zig Programming Language
← Back to News page Goodbye to the C++ Implementation of Zig December 07, 2022 How we used WebAssembly to annihilate 80,000 lines of legacy codeAuthor: Andrew Kelley It’s funny - I have shared this story a handful of times with friends of mine who are qualified, competent software engineers, and each time the response was confusion about why any of this would be necessary or even remotely helpful.
S3 Files and the changing face of S3April 07, 2026 • 6004 words Almost everyone at some point in their career has dealt with the deeply frustrating process of moving large amounts of data from one place to another, and if you haven’t, you probably just haven’t worked with large enough datasets yet. For Andy Warfield, one of those formative experiences was at UBC, working alongside genomics researc
凡例: 互換性表示: ✓=明確に表示、△=部分的/限定的に表示、✗=表示しない ソート可能: ✓=容易にソート可能、△=一部条件付きでソート可能 それでは各戦略について詳しく見ていきましょう。 SemVer（Semantic Versioning） SemVer（セマンティック バージョニング）は最も広く使われているバージョン戦略の一つです。2010年にGitHub創設者のTom Preston-Werner氏によって提案され、事実上オープンソースコミュニティの標準となっています。npmやRubyGems、Cargoといった主要なパッケージ管理システムでも採用されており、もはやバージョニングと言えばSemVerと言っても過言ではありません。 概要 バージョン番号にソフトウェアの後方互換性の有無を明示し、開発者と利用者の双方に安心感を与えることを目的としています。変更内容の重要度に応じてバー
私が個人的に使っている Git コミットメッセージのテンプレートがこちら。 変更内容のコミットメッセージを入力してください。 '#' で始まる行は無視され、空のメッセージはコミットを中止します。 コミットメッセージは 1 行目に変更内容の概要を記載し、 3 行目以降に変更内容の詳細や、コードで表現できない変更理由を説明してください。 1 行目、すなわちヘッダーはこのソフトウェアの利用者に伝わる形で書いてください。 そのまま CHANGELOG に記載できる形になっていることが望ましいです。 過去形や体言止めではなく現在形で書いてください。 (タグを除いた) 1 行目が次の文に続いたとして自然な形になるのが望ましいです。 もし適用されたら、このコミットは〜 3 行目以降、すなわちボディー部では「なぜ」「なんのために」「どのように」 などを説明してください。特に「なぜ」はコードで表現だけではさ
TrunkVer
TL;DR TrunkVer is a versioning scheme for continuously-delivered, trunk-based applications and systems that don't follow a release scheme. It is a syntax-compatible drop-in replacement for SemVer and replaces the version with meaningful meta data, telling you at a glance what the artifact is, when it was built and where you may find the build log. Usage GitHub Actions - name: Generate trunkver id:
【GitHub Actions】reviewdog + reusable workflows によるCI/CD共通化 - Sansan Tech Blog
この記事は Sansan Advent Calendar 2023 の13日目の記事です。および【R&D DevOps通信】の連載記事のひとつです。 こんにちは、研究開発部 Architectグループの藤岡です。 今回は部で運用しているCI/CDに関する取り組みについてお話しします。共通化のノウハウや、どういった種類のCI/CDを導入してコード品質を担保しているかといった話をしたいと思います。 そのまま使える実装例もあるので、是非参考にしてみてください。 目次 目次 CI/CD共通化 reviewdog による Pull Request へのコメント 導入しているCI/CD PythonのCI その他のCI CD 実装例 reusable workflows composite action reusable workflows を利用する例 release-drafter によるリリース
NPM Security best practices¶ The following cheatsheet covers several npm security best practices and productivity tips, useful for JavaScript and Node.js developers. This list was originally based on the 10 npm security best practices from the Snyk blog. 1) Avoid publishing secrets to the npm registry¶ Whether you’re making use of API keys, passwords or other secrets, they can very easily end up l
The first commit to the electron/electron repository was on March 13, 20131. 10 years and 27,147 more commits from 1192 unique contributors later, Electron has become one of the most popular frameworks for building desktop applications today. This milestone is the perfect opportunity to celebrate and reflect on our journey so far, and to share what we’ve learned along the way. We would not be here
Biome v1.7
Today we’re excited to announce the release of Biome v1.7! This new version provides an easy path to migrate from ESLint and Prettier. It also introduces experimental machine-readable reports for the formatter and the linter, new linter rules, and many fixes. Update Biome using the following commands: 1npm install --save-dev --save-exact @biomejs/biome@latest2npx @biomejs/biome migrate Migrate fro
In practice, computer code is constantly being transformed. At the beginning of a project, the computer code often takes the form of sketches that are gradually refined. Later, the code can be optimized or corrected, sometimes for many years. Soon enough, programmers realized that they needed to not only to store files, but also to keep track of the different versions of a given file. It is no acc
Understanding and Re-Creating the tj-actions/changed-files Supply Chain Attack
Understanding and Re-Creating the tj-actions/changed-files Supply Chain AttackAnother reason runtime security is so important, and patching ain't what it seems Update 3: Wiz research has published that the initial leak was actually due to an upstream workflow, reviewdog/actions-setup@v1. This attack was done with a local script instead of calling out to gist, but similarly printed tokens in job lo
Top 30 Argo CD Anti-Patterns to Avoid When Adopting Gitops | Codefresh
The time has finally come! After the massive success of our Docker and Kubernetes guides, we are now ready to see several anti-patterns for Argo CD. Anti-patterns are questionable practices that people adopt because they seem like a good idea at first glance, but in the long run, they make processes more complicated than necessary. Several times, we have spoken with enthusiastic teams that recogni
Upgrade best practices¶ This page explains what we (the Renovate maintainers) recommend you do to update your dependencies. General recommendations¶ In general, you should: Run Renovate on every repository Use the config:best-practices preset, instead of the config:recommended preset Use the Dependency Dashboard issue (it's on by default) Update your dependencies often Read the changelogs for the
Node.js
Notable Changes Experimental command-line argument parser API Adds util.parseArgs helper for higher level command-line argument parsing. Contributed by Benjamin Coe, John Gee, Darcy Clarke, Joe Sepi, Kevin Gibbons, Aaron Casanova, Jessica Nahulan, and Jordan Harband - #42675 Experimental ESM Loader Hooks API Node.js ESM Loader hooks now support multiple custom loaders, and composition is achieved
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
【Claude】Agent Skills入門 - はじめてのスキル作成 - - Findy Tech Blog
Findyの爆速開発を支える、価値提供を最優先にするための開発手法 - Findy Tech Blog
S3 Files and the changing face of S3
バージョンをどう付ける？18の戦略まとめ: SemVer、CalVer、ZeroVer、EffVer、RomVer、Sentimental、HashVer、GitDate、PragVer、WendtVer、SoloVer、BreakVer、Explicit、ZenVer、PVP、FloatVer、AsymptoVer、TrunkVer - Qiita
こんな Git コミットメッセージのテンプレートを設定するといいかも
NPM Security - OWASP Cheat Sheet Series
10 years of Electron 🎉 | Electron
An overview of version control in programming – Daniel Lemire's blog
Upgrade best practices - Renovate Docs