search

ser-rse-bridge / mapping-of-terms

https://ser-rse-bridge.github.io/mapping-of-terms/
1 stars 0 forks source link

Should we add a URI/links field to the schema? #1

Open hainesr opened 6 months ago

hainesr commented 6 months ago

I forgot to ask about this in the room, sorry.

I wonder if we should add a field to store a link (or links) out to further information and references. For example, with the SWEBOK terms we could link out to the sections of the online SWEBOK book we found. If we allowed this field to be an array, then we could reference multiple sources, if appropriate.

Thoughts?

bernhold commented 6 months ago

I've added a references array that we can do whatever we want with. Though for SWEBOK in particular, I was planning to key on the SWEBOK section number (perhaps with some help from a data file, depending on what the links need to look like).

bernhold commented 6 months ago

Also, @hainesr , didn't you find a markdown source for the SWEBOK somewhere? Or was that a red herring?

hainesr commented 6 months ago

Hi @bernhold, I found this: https://github.com/ligurio/swebok-v3

It looks like it's OK, but I'm not familiar enough with the material to know for sure. And I'm not entirely convinced of its legitimacy, if you know what I mean...

bernhold commented 3 months ago

In addition to the legitimacy question, I think we need to take a deeper look to make sure that the content (at least those parts of interest to us) are rendered reasonably in HTML -- in a random scan, I saw some things that looked like they might not have been faithful renderings of the PDF.

Also, structurally, that site seems to be a single webpage, where the ids on the headings look like "slugifications" of the section headings, without any information as to the numbering (except for chapters). If that's true, and we're faithfully using the same headings in our version of the toc (that was my intent) we can probably construct links mechanically without too much trouble.

Note that Timo's initial distillation from the SWEBOK provided short descriptions of the two knowledge areas (chapters) he was looking at. We could use text like that to provide more information to supplement our toc. But that's going to be work to produce at finer granularity. As of this moment, I haven't done anything with his KA descriptions as far as the website is concerned.