[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: [PATCH] Changelog: Add details about new features for SPR


  • To: George Dunlap <george.dunlap@xxxxxxxxx>, Andrew Cooper <amc96@xxxxxxxx>
  • From: Henry Wang <Henry.Wang@xxxxxxx>
  • Date: Thu, 2 Feb 2023 02:04:53 +0000
  • Accept-language: zh-CN, en-US
  • Arc-authentication-results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=arm.com; dmarc=pass action=none header.from=arm.com; dkim=pass header.d=arm.com; arc=none
  • Arc-message-signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=svshDtxdWN2s21Wp+aLP/i0FD33vykjikRArmQiPEp8=; b=bBSzF4aP1ISPTRA5xsyIG9DfiihhOYsWk9aWJjS7pJDxp1A7jIvzVmiWy+zzDLnLfWuGvEBeLCQqPpxPz/7q2mlERfriGMFMf4Uy3aGsM55sFDbTOzCtIL/+q9vMmk0Q7nkO+/1DP3hJx/PSKvWyWakuicTXBzVg+Zvt3PUzrupaCqilG47MxoDxofPE2mg206qXLK3CWHfKi2ZTSpyeKsCn/GhrYFJ1ZTHnfX0TaMRe9oa9crNzQeUPPtIk+1AoqIzQ11ow4b9FZ0/1BejFPe8PWlM291GepexJckrQ21+NgOJZLMciSF6H4whMkZMI8kkugWjAwVYvJfYVC8OULw==
  • Arc-seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=MFs9hOLp0ntjPwh5Dw9JuJVqXLS6gVJ/31qNW1IPPMBZMJx5tdVaolJRTgHy3dILOGtnfmVTvozZphsaXcvtfKwvS1whDm1QnrJXIcaOc6lSPr1bWCwZlK7765VvukMGI143bD/Dk7juhbfPVVQ8BOyxkOmxyprEPEhDmdoxShR2M1AM9iWHC/ZnLreOv9911EDErS35Mm7wqMMzFlMsEsFVzl/bsgeje0lGbPtkN1WVguus6lCZOyyasntzLNhKn5hbJiIHGfJ4mKAb6XPu9lqpZZNFDNKhI3h1HoYH16UVQcXcEafco8SifjaaL/35s4bb6xSd9hziDHUow4kqag==
  • Authentication-results-original: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=arm.com;
  • Cc: Andrew Cooper <andrew.cooper3@xxxxxxxxxx>, Xen-devel <xen-devel@xxxxxxxxxxxxxxxxxxxx>, George Dunlap <George.Dunlap@xxxxxxxxxxxxx>, Jan Beulich <JBeulich@xxxxxxxx>, Stefano Stabellini <sstabellini@xxxxxxxxxx>, Wei Liu <wl@xxxxxxx>, Julien Grall <julien@xxxxxxx>
  • Delivery-date: Thu, 02 Feb 2023 02:05:46 +0000
  • List-id: Xen developer discussion <xen-devel.lists.xenproject.org>
  • Nodisclaimer: true
  • Original-authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=arm.com;
  • Thread-index: AQHZLRqZNJwiiBkqnku+FjPpsLRxRa6yKKGwgATxtwCAAuUMgIAA90ow
  • Thread-topic: [PATCH] Changelog: Add details about new features for SPR

Hi George,

 

> From: George Dunlap <george.dunlap@xxxxxxxxx>

> Subject: Re: [PATCH] Changelog: Add details about new features for SPR

> 

> One approach would be to have someone / something (either the release manager, or an automated script)

 

An automated script would be best if possible IMHO, as the email

content would be pretty much fixed/predictable and the email is

sent periodically.

 

> periodically (monthly?  Bi-weekly?) email each maintainer a list of the commits under their remit, with an encouragement to consider what entries could be added to CHANGELOG.md.  i.e., something like this:

> 

> 8<---

> Dear $MAINTAINER_NAME,

> 

> During the last $TIME_PERIOD, the commits below have been checked into the tree which modify code under your maintainership.  Please ensure that necessary changes to CHANGELOG.md have also been comitted.

> 

> Thanks,

> $SENDER

> 

> $GIT_LOG

> ---->8

> 

> Ideally this would prompt maintainers to get into the habit of always asking for CHANGELOG entries to be added during review (which would also get developers into the habit of always including them); at which point the maintainers could just skim the commits in the email and only add he odd CHANGELOG that they may have forgotten.

> 

> Thoughts?

 

I like this idea very much :) Just a small question: As a developer, it is

not really clear to me that under what criteria would a patch/series

deserve for a changelog entry. Personally I would try to include the

CHANGELOG into my changes in the future if this criteria is cleared.

 

Kind regards,

Henry

 

> 

>  -George


 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.