I think you are correct. I did not notice it at first. :) But the points about how we describe aspects of JSON probably apply to everything RDAP related.
-andy On Tue, Jul 4, 2023 at 12:31 PM Pawel Kowalik <[email protected]> wrote: > > Hi Andy, > > Just to be sure - the comments refer to > draft-newton-regext-rdap-extensions-00, not to > draft-newton-regext-rdap-x-media-type-00, right? > > I just got confused as the comment are in the thread of the latter. > > Kind Regards, > > Pawel > > Am 26.06.23 um 15:32 schrieb Gould, James: > > Andy, > > > > Thanks for creating the draft, below is my feedback: > > > > 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. > > 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. > > 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”). > > Section 5 “Camel Casing” > > It would be better to refer to JSON members instead of JSON names. > > 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 > > [email protected] > <applewebdata://13890C55-AAE8-4BF3-A6CE-B4BA42740803/[email protected]> > > > > 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" > <[email protected] <mailto:[email protected]> on behalf of > [email protected] <mailto:[email protected]>> 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: <[email protected] <mailto:[email protected]>> > > 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 <[email protected] <mailto:[email protected]>>, Jasdip Singh > <[email protected] <mailto:[email protected]>> > > > > > > > > > > > > > > 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 > > [email protected] <mailto:[email protected]> > > 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 > [email protected] > https://www.ietf.org/mailman/listinfo/regext > > _______________________________________________ > regext mailing list > [email protected] > https://www.ietf.org/mailman/listinfo/regext _______________________________________________ regext mailing list [email protected] https://www.ietf.org/mailman/listinfo/regext
