[PATCH 2/8] docs: simplify and unify top titles in rst documents

Jani Nikula jani.nikula at intel.com
Tue Oct 25 10:19:58 UTC 2022


Can't think of why the complicated style for document titles was chosen
to begin with.

Signed-off-by: Jani Nikula <jani.nikula at intel.com>
---
 CONTRIBUTING.rst          | 6 +++---
 COPYING.rst               | 6 +++---
 MAINTAINERS.rst           | 6 +++---
 code-of-conduct.rst       | 6 +++---
 commit-access.rst         | 6 +++---
 committer-drm-intel.rst   | 6 +++---
 committer-drm-misc.rst    | 6 +++---
 committer-guidelines.rst  | 6 +++---
 dim.rst                   | 6 +++---
 drm-intel.rst             | 6 +++---
 drm-misc.rst              | 6 +++---
 drm-tip.rst               | 6 +++---
 drm.rst                   | 1 +
 getting-started.rst       | 6 +++---
 maintainer-drm-intel.rst  | 6 +++---
 maintainer-drm-misc.rst   | 6 +++---
 maintainer-guidelines.rst | 6 +++---
 qf.rst                    | 6 +++---
 repositories.rst          | 6 +++---
 19 files changed, 55 insertions(+), 54 deletions(-)

diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 1fed486ef316..282a9be35462 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -1,8 +1,8 @@
 .. _contributing:
 
-==========================
- Contributing and Contact
-==========================
+========================
+Contributing and Contact
+========================
 
 Please use the `dim-tools at lists.freedesktop.org`_ mailing list for
 contributions, questions, and discussion about the tooling and documentation.
diff --git a/COPYING.rst b/COPYING.rst
index 6bc14f2fbdc3..0e4197a0ab30 100644
--- a/COPYING.rst
+++ b/COPYING.rst
@@ -1,8 +1,8 @@
 .. _license:
 
-=========
- License
-=========
+=======
+License
+=======
 
 Copyright © 2012-2015 Intel Corporation
 
diff --git a/MAINTAINERS.rst b/MAINTAINERS.rst
index 792f183e66d8..916a7a0fb10f 100644
--- a/MAINTAINERS.rst
+++ b/MAINTAINERS.rst
@@ -1,8 +1,8 @@
 .. _maintainers:
 
-=============
- Maintainers
-=============
+===========
+Maintainers
+===========
 
 The maintainer tools and documentation is maintained by:
 
diff --git a/code-of-conduct.rst b/code-of-conduct.rst
index 75ce12ba86c1..1e4b0a1639d6 100644
--- a/code-of-conduct.rst
+++ b/code-of-conduct.rst
@@ -1,8 +1,8 @@
 .. _code-of-conduct:
 
-=================
- Code of Conduct
-=================
+===============
+Code of Conduct
+===============
 
 Please be aware the freedesktop.org Code of Conduct applies to projects it
 hosts, including the drm subsystem, igt, maintainer tools, etc:
diff --git a/commit-access.rst b/commit-access.rst
index 0366134b9f16..2a26274e5c08 100644
--- a/commit-access.rst
+++ b/commit-access.rst
@@ -1,6 +1,6 @@
-===============
- Commit Access
-===============
+=============
+Commit Access
+=============
 
 The drm-misc and drm-intel repositories operate in a maintainer/committer model
 with a large pool committers who can push patches in accordance with the stated
diff --git a/committer-drm-intel.rst b/committer-drm-intel.rst
index dc4932af4e89..b6e31514a12f 100644
--- a/committer-drm-intel.rst
+++ b/committer-drm-intel.rst
@@ -1,8 +1,8 @@
 .. _committer-drm-intel:
 
-================================
- drm-intel Committer Guidelines
-================================
+==============================
+drm-intel Committer Guidelines
+==============================
 
 This document describes the detailed merge criteria and committer guidelines for
 drm-intel. The same criteria and guidelines apply equally to both committers and
diff --git a/committer-drm-misc.rst b/committer-drm-misc.rst
index 110ca8b0525e..317587758b0c 100644
--- a/committer-drm-misc.rst
+++ b/committer-drm-misc.rst
@@ -1,8 +1,8 @@
 .. _committer-drm-misc:
 
-===============================
- drm-misc Committer Guidelines
-===============================
+=============================
+drm-misc Committer Guidelines
+=============================
 
 This document describes the detailed merge criteria and committer guidelines for
 drm-misc. The same criteria and guidelines apply equally to both committers and
diff --git a/committer-guidelines.rst b/committer-guidelines.rst
index 46ac6164bcc3..83e638b26b77 100644
--- a/committer-guidelines.rst
+++ b/committer-guidelines.rst
@@ -1,8 +1,8 @@
 .. _committer-guidelines:
 
-======================
- Committer Guidelines
-======================
+====================
+Committer Guidelines
+====================
 
 This document gathers together committer guidelines.
 
diff --git a/dim.rst b/dim.rst
index 050a12a0782c..7ef8ab0a57ea 100644
--- a/dim.rst
+++ b/dim.rst
@@ -1,6 +1,6 @@
-=====
- dim
-=====
+===
+dim
+===
 
 --------------------------------
 drm inglorious maintainer script
diff --git a/drm-intel.rst b/drm-intel.rst
index 53f75f2e0b8d..4ec96c9a10f5 100644
--- a/drm-intel.rst
+++ b/drm-intel.rst
@@ -1,8 +1,8 @@
 .. _drm-intel:
 
-===========
- drm-intel
-===========
+=========
+drm-intel
+=========
 
 --------------------------------------------------------------
 drm-intel patch and upstream merge flow and timeline explained
diff --git a/drm-misc.rst b/drm-misc.rst
index b55a5f49e5a8..dcb3074dd23f 100644
--- a/drm-misc.rst
+++ b/drm-misc.rst
@@ -1,8 +1,8 @@
 .. _drm-misc:
 
-=========
- drm-misc
-=========
+========
+drm-misc
+========
 
 -------------------------------------------------------------
 drm-misc patch and upstream merge flow and timeline explained
diff --git a/drm-tip.rst b/drm-tip.rst
index 7515ab7a3962..08206cf4c24d 100644
--- a/drm-tip.rst
+++ b/drm-tip.rst
@@ -1,8 +1,8 @@
 .. _drm-tip:
 
-=========
- drm-tip
-=========
+=======
+drm-tip
+=======
 
 The drm-tip branch (in the drm-tip repository) is the common DRM subsystem
 testing and integration tree (or "pile" to complete the reverse acronym). It's a
diff --git a/drm.rst b/drm.rst
index ff2bbe9b8bfe..0ef03d82d354 100644
--- a/drm.rst
+++ b/drm.rst
@@ -1,3 +1,4 @@
+===
 drm
 ===
 
diff --git a/getting-started.rst b/getting-started.rst
index 44043fb2e5b3..1c322657874b 100644
--- a/getting-started.rst
+++ b/getting-started.rst
@@ -1,8 +1,8 @@
 .. _getting-started:
 
-=================
- Getting Started
-=================
+===============
+Getting Started
+===============
 
 For getting started grab the latest dim (drm-intel-maintainer) script from::
 
diff --git a/maintainer-drm-intel.rst b/maintainer-drm-intel.rst
index ad8b255b769d..accf210dec03 100644
--- a/maintainer-drm-intel.rst
+++ b/maintainer-drm-intel.rst
@@ -1,8 +1,8 @@
 .. _maintainer-drm-intel:
 
-=================================
- drm-intel Maintainer Guidelines
-=================================
+===============================
+drm-intel Maintainer Guidelines
+===============================
 
 This document describes the detailed maintainer tasks for drm-intel.
 
diff --git a/maintainer-drm-misc.rst b/maintainer-drm-misc.rst
index 60044f65601a..466b29ef2237 100644
--- a/maintainer-drm-misc.rst
+++ b/maintainer-drm-misc.rst
@@ -1,8 +1,8 @@
 .. _maintainer-drm-misc:
 
-================================
- drm-misc Maintainer Guidelines
-================================
+==============================
+drm-misc Maintainer Guidelines
+==============================
 
 This document describes the detailed maintainer tasks for drm-misc.
 
diff --git a/maintainer-guidelines.rst b/maintainer-guidelines.rst
index 496c82ba5c64..a8391bb09859 100644
--- a/maintainer-guidelines.rst
+++ b/maintainer-guidelines.rst
@@ -1,8 +1,8 @@
 .. _maintainer-guidelines:
 
-=======================
- Maintainer Guidelines
-=======================
+=====================
+Maintainer Guidelines
+=====================
 
 This document gathers together maintainer guidelines.
 
diff --git a/qf.rst b/qf.rst
index 9d5ac528e4b7..4b8c49d5d647 100644
--- a/qf.rst
+++ b/qf.rst
@@ -1,6 +1,6 @@
-====
- qf
-====
+==
+qf
+==
 
 ---------------------
 quilt git flow script
diff --git a/repositories.rst b/repositories.rst
index f99a20009be3..3cb71fcaf079 100644
--- a/repositories.rst
+++ b/repositories.rst
@@ -1,8 +1,8 @@
 .. _repositories:
 
-===========================
- Repositories and Branches
-===========================
+=========================
+Repositories and Branches
+=========================
 
 All the relevant repositories and branches are described below. For the current
 list of maintainers, mailing lists, etc. please refer to MAINTAINERS_.
-- 
2.34.1



More information about the dim-tools mailing list