Skip to content

Commit 5bd95ed

Browse files
committed
add emphasis in spots
1 parent 9b3fbe3 commit 5bd95ed

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

proposed/clock-meta.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -141,24 +141,24 @@ _**Note:** Order descending chronologically._
141141

142142
There are different reasons why this interface does not enforce a specific timezone.
143143

144-
A purely technical reason is that the interface itself provides an explicit contract. Part of this contract
145-
is the value returned by the `now()` method. At the language level, the only thing we can enforce is that
144+
A purely _technical_ reason is that the interface itself provides an explicit contract. Part of this contract
145+
is the value returned by the `now()` method. At the _language_ level, the only thing we can enforce is that
146146
the returned value is of type `\DateTimeImmutable`. There is no way to enforce a certain timezone at the
147147
language level.
148148

149-
A logical reason is that the explicit contract should be usable in all situations where one needs a way to
150-
retrieve the current time. We should not make an assumption at the contract level about what the caller
149+
A _logical_ reason is that the explicit contract should be usable in all situations where one needs a way to
150+
retrieve the current time. We should not make an assumption at the _contract_ level about what the caller
151151
needs. If the contract did define that only `UTC` is returned, then use cases that require something else
152-
will have to explicitly work around the returned `UTC` timezone. This is different from issues such as
153-
immutability, which also cannot be enforced on the language level, but which is still necessary to
154-
adhere to other calls on the contract. For this `ClockInterface`, there will be no other calls.
152+
would have to explicitly work around the returned `UTC` timezone. This is different from issues such as
153+
immutability, which also cannot be enforced on the language level, but which is still necessary to adhere
154+
to other calls on the contract. For this `ClockInterface`, there will be no other calls.
155155

156-
Most importantly, the explicit contract provided by this interface does not prevent a user from using
156+
Most importantly, the explicit contract provided by this interface does not _prevent_ a user from using
157157
an implicit contract alongside logic to return a `\DateTimeImmutable` with a specific timezone. Whether
158-
that is `UTC` or `Antarctica/Troll`, it is the user who is in control of this.
158+
that is `UTC` or `Antarctica/Troll`, it is the _user_ who is in control of this.
159159

160160
The explicit contract defined by the interface does not limit a user in what they are doing. It tries to
161161
solve the problem of getting the current time in a reliable way. Whatever view on the current time that is,
162162
it is not part of the explicit contract.
163163

164-
Thus, this interface tries to be as open as possible, while at the same time, being as strict as necessary.
164+
Thus, this interface tries to be as _open as possible_, while at the same time, being as _strict as necessary_.

0 commit comments

Comments
 (0)