[PATCH 0/2] Docs/damon/maintaier-profile: document a mailing tool and community meetup series

[PATCH 0/2] Docs/damon/maintaier-profile: document a mailing tool and community meetup series

[SeongJae Park]

There is a mailing tool that developed and maintained by DAMON
maintainer aiming to support DAMON community.  Also there are DAMON
community meetup series.  Both are known to have rooms of improvements
in terms of their visibility.  Document those on the maintainer's
profile document.

SeongJae Park (2):
  Docs/mm/damon/maintainer-profile: introduce HacKerMaiL
  Docs/mm/damon/maintainer-profile: document DAMON community meetups

 Documentation/mm/damon/maintainer-profile.rst | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)


base-commit: 22077d9caaee23160745d3794c2b0956efe2ebd6
-- 
2.39.2

[PATCH 1/2] Docs/mm/damon/maintainer-profile: introduce HacKerMaiL

[SeongJae Park]

Since DAMON has merged into the mainline, I periodically received some
questions around DAMON's mailing lists based workflow.  The workflow is
not different from the normal ones that well documented, but it is also
true that it is not always easy and familiar for everyone.

I personally overcame it by developing and using a simple tool, named
HacKerMaiL (hkml)[1].  Based on my experience, I believe it is matured
enough to be used for simple workflows like that of DAMON.  Actually
some DAMON contributors and Linux kernel developers other than myself
told me they are using the tool.

As DAMON maintainer, I also believe helping new DAMON community members
onboarding to the worklow is one of the most important parts of my
responsibilities.  For the reason, the tool is announced[2] to support
DAMON community.  To further increasing the visibility of the fact,
document the tool and the support plan on DAMON maintainer's profile.

[1] https://github.com/damonitor/hackermail
[2] https://github.com/damonitor/hackermail/commit/3909dad91301

Signed-off-by: SeongJae Park <sj@kernel.org>
---
 Documentation/mm/damon/maintainer-profile.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst
index 8213cf61d38a..aede61f2d6a8 100644
--- a/Documentation/mm/damon/maintainer-profile.rst
+++ b/Documentation/mm/damon/maintainer-profile.rst
@@ -53,6 +53,22 @@ Mon-Fri) in PT (Pacific Time).  The response to patches will occasionally be
 slow.  Do not hesitate to send a ping if you have not heard back within a week
 of sending a patch.
 
+Mailing tool
+------------
+
+Like many other Linux kernel subsystems, DAMON uses the mailing lists
+(damon@lists.linux.dev and linux-mm@kvack.org) as the major communication
+channel.  There is a simple tool called HacKerMaiL (``hkml``) [8]_ , which is
+for people who are not very faimiliar with the mailing lists based
+communication.  The tool could particularly helpful for DAMON community members
+since it is developed and maintained by DAMON maintainer.  The tool is also
+officially announced to support DAMON and general Linux kernel developement
+workflow.
+
+In other words, ``hkml`` [8]_ is a mailing tool for DAMON community, which
+DAMON maintainer is committed to support.  Please feel free to try and report
+issues or feature requests for the tool to the maintainer.
+
 
 .. [1] https://git.kernel.org/akpm/mm/h/mm-unstable
 .. [2] https://git.kernel.org/sj/h/damon/next
@@ -61,3 +77,4 @@ of sending a patch.
 .. [5] https://github.com/awslabs/damon-tests/blob/master/corr/tests/kunit.sh
 .. [6] https://github.com/awslabs/damon-tests/tree/master/corr
 .. [7] https://github.com/awslabs/damon-tests/tree/master/perf
+.. [8] https://github.com/damonitor/hackermail
-- 
2.39.2

[PATCH 2/2] Docs/mm/damon/maintainer-profile: document DAMON community meetups

[SeongJae Park]

DAMON bi-weekly community meetup series has continued since 2022-08-15
for community members who prefer synchronous chat over asynchronous
mails.  Recently I got some feedbacks about the series from a few
people.  They told me the series is helpful for understanding of the
project and particiapting to the development, but it could be further
better in terms of the visibility.  Based on that, I started sending
meeting reminder for every occurrence.  For people who don't subscribe
the mailing list, however, adding an announcement on the official
document could be helpful.  Document the series on DAMON maintainer's
profile for the purpose.

Signed-off-by: SeongJae Park <sj@kernel.org>
---
 Documentation/mm/damon/maintainer-profile.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst
index aede61f2d6a8..365258aa77ff 100644
--- a/Documentation/mm/damon/maintainer-profile.rst
+++ b/Documentation/mm/damon/maintainer-profile.rst
@@ -69,6 +69,24 @@ In other words, ``hkml`` [8]_ is a mailing tool for DAMON community, which
 DAMON maintainer is committed to support.  Please feel free to try and report
 issues or feature requests for the tool to the maintainer.
 
+Community meetup
+----------------
+
+DAMON community is maintaining two bi-weekly meetup series for community
+members who prefer synchronous conversations over mails.
+
+The first one is for any discussion between every community member.  No
+reservation is needed.
+
+The seconds one is for discussions on specific topics between restricted
+members including the maintainer.  The maintainer shares the available time
+slots, and attendees should reserve one of those at least 24 hours before the
+time slot, by reaching out to the maintainer.
+
+Schedules and available reservation time slots are available at the Google doc
+[9]_ .  DAMON maintainer will also provide periodic reminder to the mailing
+list (damon@lists.linux.dev).
+
 
 .. [1] https://git.kernel.org/akpm/mm/h/mm-unstable
 .. [2] https://git.kernel.org/sj/h/damon/next
@@ -78,3 +96,4 @@ issues or feature requests for the tool to the maintainer.
 .. [6] https://github.com/awslabs/damon-tests/tree/master/corr
 .. [7] https://github.com/awslabs/damon-tests/tree/master/perf
 .. [8] https://github.com/damonitor/hackermail
+.. [9] https://docs.google.com/document/d/1v43Kcj3ly4CYqmAkMaZzLiM2GEnWfgdGbZAH3mi2vpM/edit?usp=sharing
-- 
2.39.2

Re: [PATCH 1/2] Docs/mm/damon/maintainer-profile: introduce HacKerMaiL

[Randy Dunlap]

Hi,

On 6/20/24 3:03 PM, SeongJae Park wrote:
> Since DAMON has merged into the mainline, I periodically received some
> questions around DAMON's mailing lists based workflow.  The workflow is
> not different from the normal ones that well documented, but it is also
> true that it is not always easy and familiar for everyone.
> 
> I personally overcame it by developing and using a simple tool, named
> HacKerMaiL (hkml)[1].  Based on my experience, I believe it is matured
> enough to be used for simple workflows like that of DAMON.  Actually
> some DAMON contributors and Linux kernel developers other than myself
> told me they are using the tool.
> 
> As DAMON maintainer, I also believe helping new DAMON community members
> onboarding to the worklow is one of the most important parts of my
> responsibilities.  For the reason, the tool is announced[2] to support
> DAMON community.  To further increasing the visibility of the fact,
> document the tool and the support plan on DAMON maintainer's profile.
> 
> [1] https://github.com/damonitor/hackermail
> [2] https://github.com/damonitor/hackermail/commit/3909dad91301
> 
> Signed-off-by: SeongJae Park <sj@kernel.org>
> ---
>  Documentation/mm/damon/maintainer-profile.rst | 17 +++++++++++++++++
>  1 file changed, 17 insertions(+)
> 
> diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst
> index 8213cf61d38a..aede61f2d6a8 100644
> --- a/Documentation/mm/damon/maintainer-profile.rst
> +++ b/Documentation/mm/damon/maintainer-profile.rst
> @@ -53,6 +53,22 @@ Mon-Fri) in PT (Pacific Time).  The response to patches will occasionally be
>  slow.  Do not hesitate to send a ping if you have not heard back within a week
>  of sending a patch.
>  
> +Mailing tool
> +------------
> +
> +Like many other Linux kernel subsystems, DAMON uses the mailing lists
> +(damon@lists.linux.dev and linux-mm@kvack.org) as the major communication
> +channel.  There is a simple tool called HacKerMaiL (``hkml``) [8]_ , which is
> +for people who are not very faimiliar with the mailing lists based

                               familiar

> +communication.  The tool could particularly helpful for DAMON community members

                   The tool could be particularly helpful

> +since it is developed and maintained by DAMON maintainer.  The tool is also
> +officially announced to support DAMON and general Linux kernel developement

                                                                  development

> +workflow.
> +
> +In other words, ``hkml`` [8]_ is a mailing tool for DAMON community, which
> +DAMON maintainer is committed to support.  Please feel free to try and report
> +issues or feature requests for the tool to the maintainer.
> +
>  
>  .. [1] https://git.kernel.org/akpm/mm/h/mm-unstable
>  .. [2] https://git.kernel.org/sj/h/damon/next
> @@ -61,3 +77,4 @@ of sending a patch.
>  .. [5] https://github.com/awslabs/damon-tests/blob/master/corr/tests/kunit.sh
>  .. [6] https://github.com/awslabs/damon-tests/tree/master/corr
>  .. [7] https://github.com/awslabs/damon-tests/tree/master/perf
> +.. [8] https://github.com/damonitor/hackermail

-- 
~Randy

Re: [PATCH 1/2] Docs/mm/damon/maintainer-profile: introduce HacKerMaiL

[SeongJae Park]

Hi Randy,

On Thu, 20 Jun 2024 22:00:05 -0700 Randy Dunlap <rdunlap@infradead.org> wrote:

> Hi,
> 
> On 6/20/24 3:03 PM, SeongJae Park wrote:
[...]
> > +channel.  There is a simple tool called HacKerMaiL (``hkml``) [8]_ , which is
> > +for people who are not very faimiliar with the mailing lists based
> 
>                                familiar
> 
> > +communication.  The tool could particularly helpful for DAMON community members
> 
>                    The tool could be particularly helpful
> 
> > +since it is developed and maintained by DAMON maintainer.  The tool is also
> > +officially announced to support DAMON and general Linux kernel developement
> 
>                                                                   development
> 
> > +workflow.

Thank you so much.  I will send a new version tomorrow with fixes for these.

[...]
> -- 
> ~Randy


Thanks,
SJ