Closed karafecho closed 2 months ago
Thanks for the details @karafecho, indeed moving completely the wiki pages would be a lot of work without much actual benefits
Just having one page for the Teams in the Developer documentation with the links to the teams wiki pages would be the best solution
Note that the index of the wiki also provided tables of all teams with links: KPs, ARAs, SRI
I'm not sure what the action item is for this ticket, but I think @vemonet and I are on the same page. Suggest linking out to the wiki page index of teams, rather than including a separate table within the Translator Developer Documentation. Perhaps with an opening sentence such as: "Current Translator teams are organized by type of component they are supporting and can be found in the Wiki index list here."
The landing page of the Wiki is now the official "team" information page. The main entry point from the tech docs site is via a highlighted link inside the Welcome overview page.
Looks good. Thank you, @RichardBruskiewich!
@vemonet had suggested that we migrate the Translator wiki pages to the Developer Documentation website. However, this will present complications as: (1) NCATS hosts the wiki pages and so any change will require their permission; (2) the InfoRes Catalog includes URLs for the wiki pages and so any change in the wiki page locations will require approval from the Biolink team and (manual) updates to the InfoRes Catalog; and (3) the UI pulls the URLs from the InfoRes Catalog for display to users for aid in edge interpretation and so any change in the wiki page locations or the approach we are using to expose the wiki pages will require approval from the UI team. See https://github.com/NCATSTranslator/translator-developer-documentation/issues/28.
Instead, I propose that the Developer Documentation includes links to wiki pages for Translator components such as the ARAs and KPs, rather than separate pages for each ARA and KP, which as Vincent points out, will require a duplication of effort and likely will result in discrepancies in documentation for a given resource. The KP page already contains a table with a partial listing of KPs and their wiki pages, so something similar could be created for the ARA page. Then, the separate pages for individual components (ARAX, RTX-KG2, Service Provider) could be deleted. This would clean things up a bit, in my opinion.