search

IDPros / bok

This is a public comment environment for the IDPro body of knowledge.
64 stars 26 forks source link

Convert Terminology to Data File and Call Terms from Data File #92

Closed idmken closed 2 years ago

idmken commented 2 years ago

I recommend converting the terminology.Md into a yml file. Each article calls the term from the data file to ensure the most recent term is used in each BoK article. I can do a proof of concept if interested.

hlflanagan commented 2 years ago

Thanks for the offer, but there are a couple of problems with the idea. The versions of the articles here on GitHub are only here as a way to let the community have a place to comment and discuss, and to make any changes to the article more easily visible. If we automated updating terminology in the markdown versions, we would get out of sync with what's published via the publication system that feeds bok.idpro.org.

My other concern is that authors may choose to define a term differently based on the context of what they're writing. One of my jobs is to make sure they don't reinvent definitions if they don't have to, but I don't require them to use what's already in the terminology document.

Does that make sense?

idmken commented 2 years ago

Makes sense. Thanks!