dive icon indicating copy to clipboard operation
dive copied to clipboard

[FEATURE] More unity of termonology across VIAME and DIVE documentation

Open mattdawkins opened this issue 4 years ago • 5 comments

Mostly just want to do this by upcoming tutorials

mattdawkins avatar Apr 14 '21 17:04 mattdawkins

IMO, the clearest change we could make is to drop VIAME Web and go with DIVE Web and DIVE Desktop for these products across the board.

VIAME Web was a perfect product name when we only had one web instance, but now that there are multiple instances deployed at kitware and a desktop version, there's too much collision. Internal people are confused.

  • VIAME is the ML platform and product suite.
  • VIEW is the legacy GUI
  • SEAL is very clear
  • DIVE Web is viame.kitware.com
  • DIVE Desktop is the electron client

subdavis avatar Apr 14 '21 17:04 subdavis

Interface definitions is one thing, though my greater concern when making this was:

  • Overloading the terms rapid model generation and iterative learning in https://kitware.github.io/dive/Use-Cases/, which mean different things in the context of wider VIAME
  • Using images from possibly non-NOAA data likely without permission in https://kitware.github.io/dive/Screenshots/ (also images with not great detections and one of them that still had the boxes left of fish due to video offset issue)
  • Explicitly referring to DIVE and VIAME as separate modules on https://kitware.github.io/dive/. Fine for developers, not the best for end users

I'm gonna work on a PR on the last one editing that splash page a little in a few

mattdawkins avatar Apr 20 '21 13:04 mattdawkins

https://github.com/Kitware/dive/issues/704#issuecomment-819688191

Also, we should have more visible links/references to these docs from the viame/viame repo and the original viame docs. IMO, we should encourage people to start with web (more user friendly) and then fall back onto View. It would be good if we could get a clear list of what is/isn't supported on each to help people decide.

Using images from possibly non-NOAA data likely without permission in https://kitware.github.io/dive/Screenshots/ (also images with not great detections and one of them that still had the boxes left of fish due to video offset issue)

Please point to some datasets for good screenshots

subdavis avatar Apr 20 '21 14:04 subdavis

Some food for thoughts:

  • VIAME is very specific vs DIVE is more general term
  • We may want to use VIAME-Web for marine folks and use DIVE-Web as underlying software
  • So depending on whether we are focusing on technology or domain we may want to market things little differently
  • Do we want to maket technology or domain specific tool?

aashish24 avatar Apr 20 '21 14:04 aashish24

@aashish24 as we discuss roadmapping for this project, this issue will be near-top of mind for me.

waxlamp avatar Jan 12 '22 19:01 waxlamp