Некоторые вопросы об условиях Hydra

Question

Я работаю над генератором документации Hydra для Golang. Я использовал демо в качестве примера, и мне было интересно узнать о неоднозначности в некоторых терминах гидры.

• В чем разница между hydra:title а также rdfs:label? label используется в vocab:User, но hydra:title используется для Resource а также Collection, а также в свойствах.
• Говоря о Resource а также Collectionпочему они повторно описаны в этой ApiDocumentation? Разве они не должны быть частью гидры / ядра?
• Во многих свойствах есть как hydra:title + hydra:description а также label + description которые содержат ту же информацию. Это почему? Могу ли я игнорировать один и все будет в порядке?

Заранее извиняюсь, если мне не удалось обнаружить это в спецификации, но я только недавно заинтересовался гипермедиа API, и многие концепции все еще немного туманны.

Answer 1

• В чем разница между hydra:title и rdfs: label?

rdfs: label используется для определения самого словаря. hydra:title используется для перезаписи этой метки в клиентах Hydra (которые используют ее, например, для визуализации форм). Это была первая проблема, которая была открыта, когда дальнейшее развитие Hydra было перенесено в группу сообщества W3C: Hydra ISSUE-1

• Говоря о ресурсах и коллекциях, почему они повторно описаны в этой ApiDocumentation? Разве они не должны быть частью гидры / ядра?

Они являются частью словаря ядра Гидры. Таким образом, нет необходимости переписывать их. Это был ярлык реализации, который я взял.

• Во многих свойствах есть оба: hydra:title + hydra: description и label + description, которые содержат одинаковую информацию. Это почему? Могу ли я игнорировать один и все будет в порядке?

Смотрите ответ на первый вопрос. В целом, вы должны предпочесть версии Hydra в инструменте, специфичном для Hydra, но вернитесь к свойствам rdfs.

Btw. есть специальный список рассылки для Hydra. Присоединяйтесь к W3C Community Group, если вы заинтересованы во влиянии на будущее развитие Hydra. Вы также должны обязательно объявить о своем генераторе документации.