Follow-up from "Add API documentation stubs for Vulnerabilities API changes"
The following discussion from !17364 (merged) should be addressed:
doc/api/vulnerability_issue_links.md
has almost the same content as https://docs.gitlab.com/ee/api/issue_links.html, with the exception thatlink_type
is missing. I cannot understand its relevance with vulnerabilities even after the explanation Wayne gave in !17364 (comment 315617495):When you go to the vulnerability list and create an issue from a vulnerability, it creates an issue and a modal
vulnerabilities::issue link
. The modal links an issue to the vulnerability. We are explicitly not making issues dependent on vulnerabilites (nor vice-versa).As a user, if I stumbled upon those two docs, I'd be confused. The new doc uses the same API endpoints as https://docs.gitlab.com/ee/api/issue_links.html, so how is it different?