<div dir="ltr">Hi,<div><br></div><div>I hope you were confused by my incredibly vague subject line. That's the point ;-)</div><div><br></div><div>As you're probably aware, whenever you do something with scap, it sends log entries off to the SAL. This is great because it lets us help build a history of what was deployed when--absolutely crucial when we're trying to figure out why something started breaking. What I think people might not know is that these deployment log entries can contain custom text provided by you the deployer. Here's a few samples chosen from the last couple of days:</div><div><br></div><div>```</div><div><div>20:03 demon@tin: rebuilt wikiversions.php and synchronized wikiversions files: (no justification provided)</div><div>19:27 mattflaschen@tin: Finished scap: Watchlist filters: Convert edit watchlist button to new UX and fix server-side tag filtering. T172030 (duration: 21m 23s)</div><div>19:05 mattflaschen@tin: Started scap: Watchlist filters: Convert edit watchlist button to new UX and fix server-side tag filtering. T172030</div><div>20:16 ayounsi@tin: Finished deploy [librenms/librenms@5fea59c]: (no justification provided) (duration: 00m 05s)</div><div>20:16 ayounsi@tin: Started deploy [librenms/librenms@5fea59c]: (no justification provided)</div><div>18:43 aaron@tin: Synchronized php-1.30.0-wmf.15/includes/jobqueue/jobs/HTMLCacheUpdateJob.php: 2d83569397 - Fix old regression in HTMLCacheUpdate de-duplication (duration: 00m 44s)</div></div><div>```</div><div><br></div><div>See how useful those are? But wait, what's with the (no justification provided)...that's basically useless! You're right. And I forget sometimes too. But I think a lot of people might not realize that this is the case. Basically the way it works is whatever text you type after your scap command is used as the message text. For example:</div><div><br></div><div>```</div><div># scap sync-file foo.php This is an awesome file everyone needs</div><div># scap deploy -v Nobody wants this code anyway, undeploying</div><div>```</div><div><br></div><div>This e-mail is not meant to shame anyone (or shame equally? I did include myself...), but merely as a pointer to a feature that I think is getting underused. In the last couple of months I count at least 250 deployments that lack a reason. I think we can do better :)</div><div><br></div><div>Have a great Friday!</div><div><br></div><div>-Chad</div></div>