From d89d5bf67ca753ddec818674924bc1fd8290501e Mon Sep 17 00:00:00 2001
From: Raphael Kubo da Costa <raphael.kubo.da.costa@intel.com>
Date: Tue, 7 Dec 2021 13:42:32 +0100
Subject: [PATCH] editorial: Use Web IDL's definition conventions for methods
 and getters. (#330)

Aligns with whatwg/webidl#882:
- Describe getters as "The attr getter steps are [...]".
- Describe methods as "The myMethod(arg) method steps are [...]".
---
 index.html | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/index.html b/index.html
index 2e98f9f..085b716 100644
--- a/index.html
+++ b/index.html
@@ -309,9 +309,7 @@ <h3>
           The <dfn>request()</dfn> method
         </h3>
         <p data-tests="wakelock-type.https.any.html">
-          The {{WakeLock/request()}} method, when invoked, MUST run the
-          following steps. The method takes one argument, the {{WakeLockType}}
-          |type:WakeLockType|:
+          The <code>request(|type:WakeLockType|)</code> method steps are:
         </p>
         <ol class="algorithm">
           <li>Let |document:Document| be [=this=]'s [=relevant settings
@@ -481,8 +479,8 @@ <h3>
           The <dfn>released</dfn> attribute
         </h3>
         <p data-tests="wakelock-released.https.html">
-          The {{WakeLockSentinel/released}} attribute's getter returns the
-          value of the {{WakeLockSentinel/[[Released]]}} internal slot.
+          The {{WakeLockSentinel/released}} getter steps are to return
+          [=this=].{{WakeLockSentinel/[[Released]]}}.
         </p>
         <aside class="note">
           Once a {{WakeLockSentinel}} is released,
@@ -495,8 +493,8 @@ <h3>
           The <dfn>type</dfn> attribute
         </h3>
         <p>
-          The {{WakeLockSentinel/type}} attribute corresponds to the
-          {{WakeLockSentinel}}'s <a>wake lock type</a>.
+          The {{WakeLockSentinel/type}} getter steps are to return [=this=]'s
+          <a>wake lock type</a>.
         </p>
       </section>
       <section>
@@ -504,8 +502,7 @@ <h3>
           The <dfn>release()</dfn> method
         </h3>
         <p data-tests="wakelock-onrelease.https.html">
-          The {{WakeLockSentinel/release()}} method, when invoked, MUST run the
-          following steps:
+          The {{WakeLockSentinel/release()}} method steps are:
         </p>
         <ol class="algorithm">
           <li>If <a>this</a>'s {{WakeLockSentinel/[[Released]]}} is `false`,