Hi, This stems from John Mathew et al's documentation efforts; see the brief exchange between Dietmar and I at [1]. This is written as a standalone documentation bit, the emphasis here being on the "why" and "what" rather than the "how". I can try to rebase that on top of John's series, but I think this could go in on its own. [1]: https://lkml.kernel.org/r/b974b959-7b9a-2874-dca6-674b74ad5b42@xxxxxxx Cheers, Valentin Valentin Schneider (3): sched: Document arch_scale_*_capacity() sched/doc: Document capacity aware scheduling sched/doc: Factorize bits between sched-energy.rst & sched-capacity.rst Documentation/scheduler/index.rst | 1 + Documentation/scheduler/sched-capacity.rst | 439 +++++++++++++++++++++ Documentation/scheduler/sched-energy.rst | 12 +- include/linux/sched/topology.h | 10 + kernel/sched/sched.h | 10 + 5 files changed, 462 insertions(+), 10 deletions(-) create mode 100644 Documentation/scheduler/sched-capacity.rst -- 2.27.0