* [PATCH] docs: split subtitle of Submitting patches
@ 2023-04-25 7:26 Costa Shulyupin
2023-05-30 1:20 ` Bagas Sanjaya
0 siblings, 1 reply; 3+ messages in thread
From: Costa Shulyupin @ 2023-04-25 7:26 UTC (permalink / raw)
To: Jonathan Corbet, linux-doc
Cc: Costa Shulyupin, Krzysztof Kozlowski, Akira Yokosawa,
Greg Kroah-Hartman, Thorsten Leemhuis, Lukas Bulwahn, Rong Tao,
open list
Motivation:
The original long page title in the left Content pane spans three lines:
Submitting patches: the essential
guide to getting your code into
the kernel
Issues:
- It is not readable.
- It further inflates already overpopulated Contents pane.
The solution:
- Split the long title to title and subtitle.
- Vertical bar '|' in Sphinx-doc introduces empty line to
make the subtitle closer to the title than to the following text.
Signed-off-by: Costa Shulyupin <costa.shul@redhat.com>
---
Documentation/process/submitting-patches.rst | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst
index 7a5619fecb38..051eba1bbc7f 100644
--- a/Documentation/process/submitting-patches.rst
+++ b/Documentation/process/submitting-patches.rst
@@ -1,7 +1,10 @@
.. _submittingpatches:
-Submitting patches: the essential guide to getting your code into the kernel
-============================================================================
+Submitting patches
+==================
+The essential guide to getting your code into the kernel
+
+|
For a person or company who wishes to submit a change to the Linux
kernel, the process can sometimes be daunting if you're not familiar
--
2.40.0
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH] docs: split subtitle of Submitting patches
2023-04-25 7:26 [PATCH] docs: split subtitle of Submitting patches Costa Shulyupin
@ 2023-05-30 1:20 ` Bagas Sanjaya
2023-05-30 8:52 ` Bagas Sanjaya
0 siblings, 1 reply; 3+ messages in thread
From: Bagas Sanjaya @ 2023-05-30 1:20 UTC (permalink / raw)
To: Costa Shulyupin, Jonathan Corbet, linux-doc
Cc: Krzysztof Kozlowski, Akira Yokosawa, Greg Kroah-Hartman,
Thorsten Leemhuis, Lukas Bulwahn, Rong Tao, open list
On 4/25/23 14:26, Costa Shulyupin wrote:
> Motivation:
>
> The original long page title in the left Content pane spans three lines:
>
> Submitting patches: the essential
> guide to getting your code into
> the kernel
>
I think it's OK to have that, if the title can't be further condensed.
> Issues:
> - It is not readable.
> - It further inflates already overpopulated Contents pane.
>
table of contents?
> The solution:
> - Split the long title to title and subtitle.
> - Vertical bar '|' in Sphinx-doc introduces empty line to
> make the subtitle closer to the title than to the following text.
>
Nope.
The title (as a whole) is already descriptive enough for
describing the text.
Thanks.
--
An old man doll... just what I always wanted! - Clara
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH] docs: split subtitle of Submitting patches
2023-05-30 1:20 ` Bagas Sanjaya
@ 2023-05-30 8:52 ` Bagas Sanjaya
0 siblings, 0 replies; 3+ messages in thread
From: Bagas Sanjaya @ 2023-05-30 8:52 UTC (permalink / raw)
To: Costa Shulyupin, Jonathan Corbet, linux-doc
Cc: Krzysztof Kozlowski, Akira Yokosawa, Greg Kroah-Hartman,
Thorsten Leemhuis, Lukas Bulwahn, Rong Tao, open list
On 5/30/23 08:20, Bagas Sanjaya wrote:
> On 4/25/23 14:26, Costa Shulyupin wrote:
>> Motivation:
>>
>> The original long page title in the left Content pane spans three lines:
>>
>> Submitting patches: the essential
>> guide to getting your code into
>> the kernel
>>
>
> I think it's OK to have that, if the title can't be further condensed.
>
Oops, I mean it's perfectly OK to have long title written as-is if it
can't be further condensed to convey the doc theme.
--
An old man doll... just what I always wanted! - Clara
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2023-05-30 8:52 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-04-25 7:26 [PATCH] docs: split subtitle of Submitting patches Costa Shulyupin
2023-05-30 1:20 ` Bagas Sanjaya
2023-05-30 8:52 ` Bagas Sanjaya
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).