Peter Delevoryas <p...@fb.com> writes: > On Jun 20, 2022, at 12:16 AM, Markus Armbruster > <arm...@redhat.com<mailto:arm...@redhat.com>> wrote:
[...] >> Documentation is rather terse. It basically provides a bunch of >> keywords you can throw at the search engine of your choice. Can we cut >> out that middle man and point straight to a suitable resource? > > Erg, yeah, sorry about that, you’re right, it would probably be more useful > to point to the NC-SI specification directly: > > https://www.dmtf.org/sites/default/files/standards/documents/DSP0222_1.0.0.pdf > > Note: there have been some newer revisions to the specification lately, and > the > full list of spec versions is here: > > https://www.dmtf.org/dsp/DSP0222 > > Get Version ID and the OEM Vendor extension are both specified in 1.0.0, so I > think it should be ok to link to 1.0.0. > > I’m not totally sure if I should directly link to the actual URL, but I’ll > definitely say: “This is defined in DMTF NC-SI 1.0.0” or something like that. Works for me with the full name of the spec: "DMTF Network Controller Sideband Interface (NC-SI) Specification, version 1.0.0". You can omit the version if there are no earlier ones. > Unless URL’s in the code would be preferred. Theoretically, the DMTF > spec URL should be pretty long-lasting. Feel free to add URL, too.
