In T1483#27359, @vlorentz wrote:

You are correct, except I will store mapping names, not file names (eg. because gemspec files are usually named project_name.gemspec, which is harder to query).

(2) seems the best option to me.

Can you elaborate on how this would be implemented?

merged in 4a6bb9e5f74957a127d004e9c2c0f36027085497

i agree it doesn't need to be a "button", any UI element would do

I like your wording! (and we can leave the parenthetical aside, by just deploying the feature bit by bit on the origins that support re-taking a snapshot, like repositories right now)

after D881, tox -e sphinx-dev now fails with a different error:

Exception occurred:
  File "/home/zack/dati/projects/sw-heritage/git/swh-environment/swh-docs/.tox/sphinx-dev/lib/python3.7/site-packages/sphinxcontrib/images.py", line 214, in is_remote
    .format(uri))
ValueError: Image URI `images/tasks-lister.svg` have to be local relative or absolute path to image, or remote address.
The full traceback has been saved in /tmp/sphinx-err-dv4lb4gw.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
make: *** [Makefile:61: sphinx/html] Error 2
make: Leaving directory '/home/zack/dati/projects/sw-heritage/git/swh-environment/swh-docs/docs'
WARNING [pifpaf.drivers] `psutil.Popen(pid=5714, status='terminated')` is already gone, sending SIGKILL to its process group
WARNING [pifpaf.drivers] `psutil.Popen(pid=5697, status='terminated')` is already gone, sending SIGKILL to its process group
WARNING [pifpaf.drivers] `psutil.Popen(pid=5692, status='terminated')` is already gone, sending SIGKILL to its process group
ERROR: InvocationError: '/home/zack/dati/projects/sw-heritage/git/swh-environment/swh-docs/.tox/sphinx-dev/bin/python -m pifpaf run postgresql -- make -C docs html'
___________________________________________ summary ___________________________________________
ERROR:   sphinx-dev: commands failed

the file in question (tasks-lister.svg) is properly generated by running make by hand, but it is not when the build is done by tox

this is needed and good, thanks!
but note that building docs still fails (due to a different error now), so I don't think you should close T1450 with this

@ftigeot did you try to *call* the Dell sales rep, as we discussed a while ago?

what kind of inventory we want to do with this? hardware? software? both?

LGTM

This comes from a discussion between myself and @vlorentz . To summarize my position: I would like to be able to tell downstream users "the keys we use in our metadata are (a subset of) the codemeta ones". AFAICT that means that they should be able to look them up here: https://codemeta.github.io/terms/ . As such, we should not use keys like schema:author, but simply author; similarly we should not use codemeta:issueTracker but simply issueTracker.

I've attached here T917, which was just a specific instance of this.

In D668#14656, @douardda wrote:

In fact, there are other place(s) where we can find kind of partial glossaries, especially https://docs.softwareheritage.org/devel/swh-model/data-model.html#software-artifacts . Not sure how to deal with this later one however. It makes sense to keep these definitions explicitly in this document, IMHO.

Regarding the glossary, we also had https://wiki.softwareheritage.org/wiki/Glossary ; once this is pushed the wiki glossary should be deprecated/deleted in favor of the docs.s.o one. In the meanwhile there might be entries there that are missing here (I haven't checked, but wanted to mention potentially useful previous work :-))