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

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

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
>

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

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).

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