search

MSO4SC / book.mso4sc.eu

Website for Pilots description
http://book.mso4sc.cemosis.fr
GNU General Public License v3.0
2 stars 10 forks source link

Add Feel++ Eye2brain apps documentation #26

Open prudhomm opened 6 years ago

prudhomm commented 6 years ago

Eye2brain applications on MSO4SC need to be documented:

lsala commented 6 years ago

Sorry @prudhomm could you be a little bit more specific where do we have to write this documentation? I know that the application is already described here: http://book.mso4sc.cemosis.fr/pilots/0.1/feelpp/eye2brain/README/

And if I understand correctly, the documentation you are asking for is related "how to run the application and how to visualize the results", isn't it? Therefore don't we need to know (or at least I'm not acknowledged) how is portal working with the application that works on the web interface?

gdolle commented 6 years ago

@lsala The documentation will be related to the portal from an end-user/developer point of view (explain how to use app, how to visualize results using the portal, and a link to the eye2brain book for full math doc). This doc is more the description of the different pilots.

@prudhomm We should probably reorganize a bit the navigation to better distinguish the technical doc (someone who install the platform), the end-user doc (someone who buy and use app) and a developer doc (someone who provide and sell app). For now, I think we can add a user component, and a feelpp module https://github.com/MSO4SC/book.mso4sc.eu/tree/master/docs

(@prudhomm Shouldn't the two first points go in a private documentation (component) ?)

@prudhomm Maybe we could propose to the techboard a fast-short mutual mso4sc documentation sprint with other partners for the first week of june to prepare ECMI? (Then we should prepare all the required documentation (blank) pages with navs so that partners have just to click the edit button to contribute directly to the content from github, it'd simplify the process) What do you think ?

lsala commented 6 years ago

Thank you @gdolle for the answer, however it is not clear to me how I can explain in a doc the work of the application on the portal if I don't know how I can access the portal - if it's ready - and how it works

gdolle commented 6 years ago

@lsala I understand. When I come back we can have a look at that together with @jbwahl if you want. Also, we have to re-add eye2brain apps in the portal since the last update, so we can do both things all-together.

prudhomm commented 6 years ago

@lsala there are several assignees, you are one of them. I currently cannot use the portal :( but I hope to be able to use it for all our apps. We will need to contribute documentation that is seriously lacking on how to run our applications on the portal. the issue is an attempt to organize the work and get people on board.