* [PATCH] Documentation: bcachefs: Add explicit title for idle work design doc
@ 2025-08-20 0:22 Bagas Sanjaya
2025-08-20 1:08 ` Kent Overstreet
2025-08-20 1:18 ` Randy Dunlap
0 siblings, 2 replies; 6+ messages in thread
From: Bagas Sanjaya @ 2025-08-20 0:22 UTC (permalink / raw)
To: Linux Kernel Mailing List, Linux Documentation, Linux bcachefs
Cc: Kent Overstreet, Jonathan Corbet, Bagas Sanjaya
Commit 9e260e4590e044 ("docs: bcachefs: idle work scheduling design doc")
adds design doc (desiderata) for idle work scheduling, but missed
explicit title, causing its two section headings to be toctree entries
instead.
Add the title.
Fixes: 9e260e4590e0 ("docs: bcachefs: idle work scheduling design doc")
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
---
Documentation/filesystems/bcachefs/future/idle_work.rst | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/Documentation/filesystems/bcachefs/future/idle_work.rst b/Documentation/filesystems/bcachefs/future/idle_work.rst
index 59a332509dcd97..30f2844c3d9e5e 100644
--- a/Documentation/filesystems/bcachefs/future/idle_work.rst
+++ b/Documentation/filesystems/bcachefs/future/idle_work.rst
@@ -1,4 +1,5 @@
-Idle/background work classes design doc:
+Idle/background work classes desiderata
+=======================================
Right now, our behaviour at idle isn't ideal, it was designed for servers that
would be under sustained load, to keep pending work at a "medium" level, to
base-commit: 37c52167b007d9d0bb8c5ed53dd6efc4969a1356
--
An old man doll... just what I always wanted! - Clara
^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation: bcachefs: Add explicit title for idle work design doc
2025-08-20 0:22 [PATCH] Documentation: bcachefs: Add explicit title for idle work design doc Bagas Sanjaya
@ 2025-08-20 1:08 ` Kent Overstreet
2025-08-20 2:29 ` Bagas Sanjaya
2025-08-20 1:18 ` Randy Dunlap
1 sibling, 1 reply; 6+ messages in thread
From: Kent Overstreet @ 2025-08-20 1:08 UTC (permalink / raw)
To: Bagas Sanjaya
Cc: Linux Kernel Mailing List, Linux Documentation, Linux bcachefs,
Jonathan Corbet
On Wed, Aug 20, 2025 at 07:22:18AM +0700, Bagas Sanjaya wrote:
> Commit 9e260e4590e044 ("docs: bcachefs: idle work scheduling design doc")
> adds design doc (desiderata) for idle work scheduling, but missed
> explicit title, causing its two section headings to be toctree entries
> instead.
>
> Add the title.
>
> Fixes: 9e260e4590e0 ("docs: bcachefs: idle work scheduling design doc")
> Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
> ---
> Documentation/filesystems/bcachefs/future/idle_work.rst | 3 ++-
> 1 file changed, 2 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/filesystems/bcachefs/future/idle_work.rst b/Documentation/filesystems/bcachefs/future/idle_work.rst
> index 59a332509dcd97..30f2844c3d9e5e 100644
> --- a/Documentation/filesystems/bcachefs/future/idle_work.rst
> +++ b/Documentation/filesystems/bcachefs/future/idle_work.rst
> @@ -1,4 +1,5 @@
> -Idle/background work classes design doc:
> +Idle/background work classes desiderata
.....
what's going on with that spelling?
> +=======================================
>
> Right now, our behaviour at idle isn't ideal, it was designed for servers that
> would be under sustained load, to keep pending work at a "medium" level, to
>
> base-commit: 37c52167b007d9d0bb8c5ed53dd6efc4969a1356
> --
> An old man doll... just what I always wanted! - Clara
>
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation: bcachefs: Add explicit title for idle work design doc
2025-08-20 0:22 [PATCH] Documentation: bcachefs: Add explicit title for idle work design doc Bagas Sanjaya
2025-08-20 1:08 ` Kent Overstreet
@ 2025-08-20 1:18 ` Randy Dunlap
1 sibling, 0 replies; 6+ messages in thread
From: Randy Dunlap @ 2025-08-20 1:18 UTC (permalink / raw)
To: Bagas Sanjaya, Linux Kernel Mailing List, Linux Documentation,
Linux bcachefs
Cc: Kent Overstreet, Jonathan Corbet
Hi,
On 8/19/25 5:22 PM, Bagas Sanjaya wrote:
> Commit 9e260e4590e044 ("docs: bcachefs: idle work scheduling design doc")
> adds design doc (desiderata) for idle work scheduling, but missed
> explicit title, causing its two section headings to be toctree entries
> instead.
>
> Add the title.
>
> Fixes: 9e260e4590e0 ("docs: bcachefs: idle work scheduling design doc")
> Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
> ---
> Documentation/filesystems/bcachefs/future/idle_work.rst | 3 ++-
> 1 file changed, 2 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/filesystems/bcachefs/future/idle_work.rst b/Documentation/filesystems/bcachefs/future/idle_work.rst
> index 59a332509dcd97..30f2844c3d9e5e 100644
> --- a/Documentation/filesystems/bcachefs/future/idle_work.rst
> +++ b/Documentation/filesystems/bcachefs/future/idle_work.rst
> @@ -1,4 +1,5 @@
> -Idle/background work classes design doc:
> +Idle/background work classes desiderata
> +=======================================
I agree with the underline change and tested it. However, I don't care
for the change in the wording.
>
> Right now, our behaviour at idle isn't ideal, it was designed for servers that
> would be under sustained load, to keep pending work at a "medium" level, to
>
> base-commit: 37c52167b007d9d0bb8c5ed53dd6efc4969a1356
Tested-by: Randy Dunlap <rdunlap@infradead.org>
--
~Randy
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation: bcachefs: Add explicit title for idle work design doc
2025-08-20 1:08 ` Kent Overstreet
@ 2025-08-20 2:29 ` Bagas Sanjaya
2025-08-20 2:31 ` Kent Overstreet
0 siblings, 1 reply; 6+ messages in thread
From: Bagas Sanjaya @ 2025-08-20 2:29 UTC (permalink / raw)
To: Kent Overstreet
Cc: Linux Kernel Mailing List, Linux Documentation, Linux bcachefs,
Jonathan Corbet
[-- Attachment #1: Type: text/plain, Size: 383 bytes --]
On Tue, Aug 19, 2025 at 09:08:22PM -0400, Kent Overstreet wrote:
> > -Idle/background work classes design doc:
> > +Idle/background work classes desiderata
>
> .....
> what's going on with that spelling?
I'm just suggesting a better title, though. Should I keep it or revert back
to design doc?
Confused...
--
An old man doll... just what I always wanted! - Clara
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation: bcachefs: Add explicit title for idle work design doc
2025-08-20 2:29 ` Bagas Sanjaya
@ 2025-08-20 2:31 ` Kent Overstreet
2025-08-20 3:11 ` Bagas Sanjaya
0 siblings, 1 reply; 6+ messages in thread
From: Kent Overstreet @ 2025-08-20 2:31 UTC (permalink / raw)
To: Bagas Sanjaya
Cc: Linux Kernel Mailing List, Linux Documentation, Linux bcachefs,
Jonathan Corbet
On Wed, Aug 20, 2025 at 09:29:19AM +0700, Bagas Sanjaya wrote:
> On Tue, Aug 19, 2025 at 09:08:22PM -0400, Kent Overstreet wrote:
> > > -Idle/background work classes design doc:
> > > +Idle/background work classes desiderata
> >
> > .....
> > what's going on with that spelling?
>
> I'm just suggesting a better title, though. Should I keep it or revert back
> to design doc?
Revert back to design doc, please.
(I genuinely had not seen that word before; usually prefer to keep
things simple).
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] Documentation: bcachefs: Add explicit title for idle work design doc
2025-08-20 2:31 ` Kent Overstreet
@ 2025-08-20 3:11 ` Bagas Sanjaya
0 siblings, 0 replies; 6+ messages in thread
From: Bagas Sanjaya @ 2025-08-20 3:11 UTC (permalink / raw)
To: Kent Overstreet
Cc: Linux Kernel Mailing List, Linux Documentation, Linux bcachefs,
Jonathan Corbet
[-- Attachment #1: Type: text/plain, Size: 686 bytes --]
On Tue, Aug 19, 2025 at 10:31:43PM -0400, Kent Overstreet wrote:
> On Wed, Aug 20, 2025 at 09:29:19AM +0700, Bagas Sanjaya wrote:
> > On Tue, Aug 19, 2025 at 09:08:22PM -0400, Kent Overstreet wrote:
> > > > -Idle/background work classes design doc:
> > > > +Idle/background work classes desiderata
> > >
> > > .....
> > > what's going on with that spelling?
> >
> > I'm just suggesting a better title, though. Should I keep it or revert back
> > to design doc?
>
> Revert back to design doc, please.
>
> (I genuinely had not seen that word before; usually prefer to keep
> things simple).
OK, thanks!
--
An old man doll... just what I always wanted! - Clara
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2025-08-20 3:11 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-08-20 0:22 [PATCH] Documentation: bcachefs: Add explicit title for idle work design doc Bagas Sanjaya
2025-08-20 1:08 ` Kent Overstreet
2025-08-20 2:29 ` Bagas Sanjaya
2025-08-20 2:31 ` Kent Overstreet
2025-08-20 3:11 ` Bagas Sanjaya
2025-08-20 1:18 ` Randy Dunlap
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).