Andy,
Thanks for creating the draft, below is my feedback:
1. Section 2 “RDAP Extension Identifier”
* It would be better to refer to JSON members instead of JSON attribute
names to be more consistent with RFC 9083.
* I would make it clear that the extension identifier can prepend or
match the path segments and JSON members, such as the use of “redacted”
extension identifier in draft-ietf-regext-rdap-redacted that is used for the
“redacted” JSON member of the extension. Prepending does support matching, but
I would be more explicit.
2. Section 3 “Usage in Queries”
* Same feedback from section 2, where the extension identifiers prepend
or match the path segments. In the case of multiple path segments, you can
separate the extension identifier from the path segment value with an underbar
(e.g., foobar_fizz and foobar_fazz) in the example you provide.
3. Section 4 “Usage in JSON”
* It would be better to refer to JSON members instead of JSON names.
* Same feedback from section 2, where the extension identifiers prepend
or match the JSON members. The RDAP versioning extension
(draft-gould-regext-rdap-versioning) provides an example of matching the
extension identifier in the query response with “versioning” and use of the
extension identifier as a prefix for the help response (should be
“versioning_help” instead of “versioning-help”).
4. Section 5 “Camel Casing”
* It would be better to refer to JSON members instead of JSON names.
5. Section 7 “Extension Versioning“
* I would change the section title to “Versioning in Extension
Identifiers”, since extensions can certainly have versioning, but the extension
identifiers do not include any explicit versioning.
* I would change the references in the section of “RDAP extensions” to
“RDAP extension identifiers”. For example, “That is, the RDAP extension
identifiers are opaquely versioned”.
Thanks,
--
JG
James Gould
Fellow Engineer
jgo...@verisign.com
<applewebdata://13890C55-AAE8-4BF3-A6CE-B4BA42740803/jgo...@verisign.com>
703-948-3271
12061 Bluemont Way
Reston, VA 20190
Verisign.com <http://verisigninc.com/>
On 5/21/23, 10:36 PM, "regext on behalf of Andrew Newton"
<regext-boun...@ietf.org <mailto:regext-boun...@ietf.org> on behalf of
a...@hxr.us <mailto:a...@hxr.us>> wrote:
Caution: This email originated from outside the organization. Do not click
links or open attachments unless you recognize the sender and know the content
is safe.
Hi all,
Jasdip and I have put together a draft for a new RDAP media type. This
allows clients to signal their supported extensions. By using a media
type, this signaling survives redirects and is backward compatible
with the RDAP RFCs and the currently deployed RDAP ecosystem.
We even have some demo code to show how it works:
https://secure-web.cisco.com/1vRQc9yIEtZ13eYnKDqW81F4k6q7cchX3N8mZFqkP5Yabk4J8yOsdQ6XUzS9wYEsHarDVy5m_i0VIwJnfzEfCeU3qf3sL4C-MCl2Kw_50BwWS2VUJ4pahCMhbiHRa5Chfl-lzAguOVvLdJZuhfuSr8OF06Qm7vLWaUl89-BGh3Jh6RNsBF4aGqC8IICTceEeiiqW3X5fnifXnJh5e0ZapDM7SRwjhUt_D0hs8MfTcHKQtdbDrh4CMVqMHrTEVJhz8KI0Mf-UwuEM7NABHQbjUM_URrFC61gpYw1MR7QXfLtQ/https%3A%2F%2Fgithub.com%2Fanewton1998%2Fdraft-regext-ext-json-media-type%2Ftree%2Fmain%2Fdemo
<https://secure-web.cisco.com/1vRQc9yIEtZ13eYnKDqW81F4k6q7cchX3N8mZFqkP5Yabk4J8yOsdQ6XUzS9wYEsHarDVy5m_i0VIwJnfzEfCeU3qf3sL4C-MCl2Kw_50BwWS2VUJ4pahCMhbiHRa5Chfl-lzAguOVvLdJZuhfuSr8OF06Qm7vLWaUl89-BGh3Jh6RNsBF4aGqC8IICTceEeiiqW3X5fnifXnJh5e0ZapDM7SRwjhUt_D0hs8MfTcHKQtdbDrh4CMVqMHrTEVJhz8KI0Mf-UwuEM7NABHQbjUM_URrFC61gpYw1MR7QXfLtQ/https%3A%2F%2Fgithub.com%2Fanewton1998%2Fdraft-regext-ext-json-media-type%2Ftree%2Fmain%2Fdemo>
-andy
---------- Forwarded message ---------
From: <internet-dra...@ietf.org <mailto:internet-dra...@ietf.org>>
Date: Sun, May 21, 2023 at 10:26 PM
Subject: New Version Notification for
draft-newton-regext-rdap-x-media-type-00.txt
To: Andy Newton <a...@hxr.us <mailto:a...@hxr.us>>, Jasdip Singh
<jasd...@arin.net <mailto:jasd...@arin.net>>
A new version of I-D, draft-newton-regext-rdap-x-media-type-00.txt
has been successfully submitted by Andy Newton and posted to the
IETF repository.
Name: draft-newton-regext-rdap-x-media-type
Revision: 00
Title: An RDAP With Extensions Media Type
Document date: 2023-05-21
Group: Individual Submission
Pages: 10
URL:
https://secure-web.cisco.com/1Zy0H8UzvzEBBDkFv-crlCZ8_sbHpdKDUvCU-z9pyKitatAG9921vRsmo8kETZ8E9mfa0vu707fwKtgpPmLhOo1n5Zb0DChdROrujLnm9ZkU0bB8PUB5bsyXQjkfyQ0F2QNRJI8yzoo6U7P6_xTc9wCJBgHHCGXU6BW2QnxBLBy0G5N1oBJkqdsqWCry_o43GjD-Z8jrA0-5imMF6rrzUYKVOH5Tj4qlbpJrn-299zrkzbHonQKLtBwRtlL2Af2rZPJzHxJXlrazvBBtx_oH_mcMble7PO6wWSZYo7l5930o/https%3A%2F%2Fwww.ietf.org%2Farchive%2Fid%2Fdraft-newton-regext-rdap-x-media-type-00.txt
<https://secure-web.cisco.com/1Zy0H8UzvzEBBDkFv-crlCZ8_sbHpdKDUvCU-z9pyKitatAG9921vRsmo8kETZ8E9mfa0vu707fwKtgpPmLhOo1n5Zb0DChdROrujLnm9ZkU0bB8PUB5bsyXQjkfyQ0F2QNRJI8yzoo6U7P6_xTc9wCJBgHHCGXU6BW2QnxBLBy0G5N1oBJkqdsqWCry_o43GjD-Z8jrA0-5imMF6rrzUYKVOH5Tj4qlbpJrn-299zrkzbHonQKLtBwRtlL2Af2rZPJzHxJXlrazvBBtx_oH_mcMble7PO6wWSZYo7l5930o/https%3A%2F%2Fwww.ietf.org%2Farchive%2Fid%2Fdraft-newton-regext-rdap-x-media-type-00.txt>
Status:
https://secure-web.cisco.com/1WoZczv98b_VYLPdW3niQTAXGicG11lNmRaYIArEIkaq0g7S2Y-ya2dKkpZ4x5486FeKIA2gS9YSh7FNfbWeDKxZMr0tjfyXQdTpP2OYN1nsOzxzMbLGRzk18XH7v2s91gwr6EpQrFNuSwykYmUUDAnqQCWTAWc6pQXtSz68Ysccu1L871hc04bDsHJKQ9TYTM8gLLoVpMMGtbtipNr7rMWJmLJ0EAR9Q9MvUuOWT7vqy_koggS0DZVOiNaXC9TP8fhv7rfjX87ouJtS4uJXZTU3MolxT8l-uo-wwDRfvhT0/https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fdraft-newton-regext-rdap-x-media-type%2F
<https://secure-web.cisco.com/1WoZczv98b_VYLPdW3niQTAXGicG11lNmRaYIArEIkaq0g7S2Y-ya2dKkpZ4x5486FeKIA2gS9YSh7FNfbWeDKxZMr0tjfyXQdTpP2OYN1nsOzxzMbLGRzk18XH7v2s91gwr6EpQrFNuSwykYmUUDAnqQCWTAWc6pQXtSz68Ysccu1L871hc04bDsHJKQ9TYTM8gLLoVpMMGtbtipNr7rMWJmLJ0EAR9Q9MvUuOWT7vqy_koggS0DZVOiNaXC9TP8fhv7rfjX87ouJtS4uJXZTU3MolxT8l-uo-wwDRfvhT0/https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fdraft-newton-regext-rdap-x-media-type%2F>
Html:
https://secure-web.cisco.com/1CK0G-mVgqHY1XgneRSalGr_hQp0MOEb27ml_Ba7dT7oKiufTSkh-BdeMkDhWXOIa7ItaVgkthVFnI6XvtBQZJGK04aN4ixpBSbE2_wWNddHxsG3m3xLlrDr6C-cLEbPx9TwnpY1x3cJSsbKQ5LJEFg6YFcTX8E2IfRq-gPVTfhL5wXKNxi4E_n79_Nc2X7r8fuNucGSon8gLvWSezqFfIxUDtgXf69-Fc6v5hsIVMoxRb3obS9mBelOw-9h-hnkYafS08SckCEiUe7UUR8JknKNlHT_jZ5tUPA81BmWcvro/https%3A%2F%2Fwww.ietf.org%2Farchive%2Fid%2Fdraft-newton-regext-rdap-x-media-type-00.html
<https://secure-web.cisco.com/1CK0G-mVgqHY1XgneRSalGr_hQp0MOEb27ml_Ba7dT7oKiufTSkh-BdeMkDhWXOIa7ItaVgkthVFnI6XvtBQZJGK04aN4ixpBSbE2_wWNddHxsG3m3xLlrDr6C-cLEbPx9TwnpY1x3cJSsbKQ5LJEFg6YFcTX8E2IfRq-gPVTfhL5wXKNxi4E_n79_Nc2X7r8fuNucGSon8gLvWSezqFfIxUDtgXf69-Fc6v5hsIVMoxRb3obS9mBelOw-9h-hnkYafS08SckCEiUe7UUR8JknKNlHT_jZ5tUPA81BmWcvro/https%3A%2F%2Fwww.ietf.org%2Farchive%2Fid%2Fdraft-newton-regext-rdap-x-media-type-00.html>
Htmlized:
https://secure-web.cisco.com/1GrhyTTE-K0oFVSgLSDCxO_XZXFH4RvCkHZsBNJN6-IH46FewVDHfZtsrvAj-EFR_2Czu_Oq1yxqg4AorisBnyu7MHgX9T8IQivu2jjSg3juhs0uMzhkaPCdPJbsz9MG71KMoLGjXD1cdeXhXwrplTZwxsWciqhu0AvtewbXQmfOCJHtHfZIrulOYs-e2PdbEO_LVoiIBYdGuMC3tUia-fMoFeddmfgemevKCWmrRqDVYSBGT6R6DFvh28WYMzXDK-MI4zJvoJBu7uFf40pIgqv3fRLhR5Kp38z5Cf13yz04/https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Fdraft-newton-regext-rdap-x-media-type
<https://secure-web.cisco.com/1GrhyTTE-K0oFVSgLSDCxO_XZXFH4RvCkHZsBNJN6-IH46FewVDHfZtsrvAj-EFR_2Czu_Oq1yxqg4AorisBnyu7MHgX9T8IQivu2jjSg3juhs0uMzhkaPCdPJbsz9MG71KMoLGjXD1cdeXhXwrplTZwxsWciqhu0AvtewbXQmfOCJHtHfZIrulOYs-e2PdbEO_LVoiIBYdGuMC3tUia-fMoFeddmfgemevKCWmrRqDVYSBGT6R6DFvh28WYMzXDK-MI4zJvoJBu7uFf40pIgqv3fRLhR5Kp38z5Cf13yz04/https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Fdraft-newton-regext-rdap-x-media-type>
Abstract:
This document defines a media type for RDAP that can be used to
describe RDAP content with RDAP extensions. Additionally, this
document describes the usage of this media type with RDAP.
The IETF Secretariat
_______________________________________________
regext mailing list
regext@ietf.org <mailto:regext@ietf.org>
https://secure-web.cisco.com/1C8sLMltcoF0Tdh1Plg0qpBO41PST7VqVTdQ78Fpf0CWGetzu6l6kIDM8z78TAxAbZjU6YQfHuTcxY9gtuK4REIMKdRCwXQJlsF1qXtmHD32e5_0saOFKCkhPfGctMbCzZTBcO3JHHN1vhWiTmUZPLpGEuvMK_SGnZEJSjaoACxo-eWXochUg1pgfSvs5FS9d-4CQk_3gOBn6xXuP0fBA0kloYpoPMqJMM40AZpZBVA-x4pZEbTtyxfKo6ajiquaBC4RhxJSoPGBgvSMQ-tlHFW_jjUzjiW4ANuJYrg11Ens/https%3A%2F%2Fwww.ietf.org%2Fmailman%2Flistinfo%2Fregext
<https://secure-web.cisco.com/1C8sLMltcoF0Tdh1Plg0qpBO41PST7VqVTdQ78Fpf0CWGetzu6l6kIDM8z78TAxAbZjU6YQfHuTcxY9gtuK4REIMKdRCwXQJlsF1qXtmHD32e5_0saOFKCkhPfGctMbCzZTBcO3JHHN1vhWiTmUZPLpGEuvMK_SGnZEJSjaoACxo-eWXochUg1pgfSvs5FS9d-4CQk_3gOBn6xXuP0fBA0kloYpoPMqJMM40AZpZBVA-x4pZEbTtyxfKo6ajiquaBC4RhxJSoPGBgvSMQ-tlHFW_jjUzjiW4ANuJYrg11Ens/https%3A%2F%2Fwww.ietf.org%2Fmailman%2Flistinfo%2Fregext>
_______________________________________________
regext mailing list
regext@ietf.org
https://www.ietf.org/mailman/listinfo/regext
