Skip to content

Commit 6e287ab

Browse files
committed
Improve documentation warning on resource usage
1 parent b997751 commit 6e287ab

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -160,18 +160,18 @@ To instantiate each domain resolver you can use the following named constructor:
160160

161161
**WARNING:**
162162

163-
**You should never resolve domain name this way in production, without, at
163+
**You SHOULD never resolve domain name this way in production, without, at
164164
least, a caching mechanism to reduce PSL downloads.**
165165

166166
**Using the Public Suffix List to determine what is a valid domain name and what
167-
isn't is dangerous, particularly in these days when new gTLDs are arriving at a
168-
rapid pace.**
167+
isn't is dangerous, and MAY lead to errors because of new gTLDs being registered
168+
on a regular basis.**
169169

170-
**If you are looking to know the validity of a Top Level Domain, the
171-
IANA Top Level Domain List is the proper source for this information or
172-
alternatively consider using directly the DNS.**
170+
**If you are looking to know the validity of a Top Level Domain, you MUST use
171+
the IANA Top Level Domain List as the proper source for this information or
172+
alternatively the DNS.**
173173

174-
**If you must use this library for any of the above purposes, please consider
174+
**If you MUST use this library for any of the above purposes, you SHOULD consider
175175
integrating an updating mechanism into your software.**
176176

177177
**For more information go to the [Managing external data source section](#managing-the-package-external-resources)**

0 commit comments

Comments
 (0)