On 04/08/20 12:26, peterz@xxxxxxxxxxxxx wrote: > On Fri, Jul 31, 2020 at 08:20:15PM +0100, Valentin Schneider wrote: >> Add some documentation detailing the concepts, requirements and >> implementation of capacity aware scheduling across the different scheduler >> classes. >> >> Signed-off-by: Valentin Schneider <valentin.schneider@xxxxxxx> >> --- >> Documentation/scheduler/index.rst | 1 + >> Documentation/scheduler/sched-capacity.rst | 439 +++++++++++++++++++++ > > How about I make this a .txt file and remove all that unreadable rst > nonsense? I wouldn't mind *too* much, all diagrams are ASCII-based and the rest would just be plain text. I get that the whole backtick thing is a bit annoying, but it's only there for symbols that aren't functions (since "foo()" gets automagically detected as a C reference), and because they aren't functions I would've gone for some other form of emphasis anyway (quotes or asterisks or something). That said, Ingo picked it up early and it's already gone in via the sched/core PR.