search

decentralized-identity / spec-up

Create beautiful, feature-rich technical specifications in markdown
https://identity.foundation/spec-up/
Apache License 2.0
34 stars 28 forks source link

How to include normative references that are not W3C, IETF and WHATWG? #57

Closed awoie closed 11 months ago

awoie commented 11 months ago

If I have ISO docs, how would I include them in the normative references table?

awoie commented 11 months ago

@csuwildcat @decentralgabe Can either of you help?

decentralgabe commented 11 months ago

@awoie I usually manually add in references using [[ref: ... ]]

@csuwildcat would need to add something to the processing to pull in ISO docs I believe

awoie commented 11 months ago

@awoie I usually manually add in references using [[ref: ... ]]

@decentralgabe can you give an example? I cannot find anything related to this in the docs.

decentralgabe commented 11 months ago

yes, see the references here for ed25519 and a few others that aren't a part of a group -- https://did-dht.com/#references

https://github.com/TBD54566975/did-dht-method/blob/main/spec/spec.md#references

awoie commented 11 months ago

https://github.com/TBD54566975/did-dht-method/blob/main/spec/spec.md#references

Thank you so much. We should add that to the example spec/docs. This is would be very useful.

Just in case somebody else is looking for an answer.

# Some Section

EdDSA [[ref:Ed25519]] is a great!

# References

[[def:Ed25519]]
~ [Ed25519](https://ed25519.cr.yp.to/). D. J. Bernstein, N. Duif, T. Lange, P. Schwabe, B.-Y. Yang; 26 September 2011.
[ed25519.cr.yp.to](https://ed25519.cr.yp.to/).

[[spec]]

^^ [[spec]] would then include the remaining more straight-forward references.