open-simulation-interface icon indicating copy to clipboard operation
open-simulation-interface copied to clipboard

Test scripts undocumented

Open ClemensLinnhoff opened this issue 2 years ago • 6 comments

Describe the bug

The python unit tests in the tests/ folder are undocumented. There is a documentation page but it is practically empty and can only be found via the search and not via the navigation bar on the left.

Describe the expected behavior

A general description of the tests is needed (how to run them, where they are run in the pipeline) and a description for every individual test is needed.

And the documentation page needs to be accessible via the navigation bar.

ClemensLinnhoff avatar Jan 17 '24 15:01 ClemensLinnhoff

@philipwindecker @florianwallerer probably we should discuss this in our next CCB meeting?

PhRosenberger avatar Jan 17 '24 15:01 PhRosenberger

@philipwindecker @florianwallerer probably we should discuss this in our next CCB meeting?

I will first check with Ben if we can invest the hours to do the documentation work. I hope, I have an answer until the next CCb meeting.

florianwallerer avatar Jan 17 '24 15:01 florianwallerer

Thx! (This was part of the discussion I planed.)

PhRosenberger avatar Jan 17 '24 16:01 PhRosenberger

@florianwallerer as there seems to be no budget in the current OSI project for docu, how do we continue here?

PhRosenberger avatar Feb 12 '24 14:02 PhRosenberger

@florianwallerer as there seems to be no budget in the current OSI project for docu, how do we continue here?

I am still in discussion with Ben. He has a lot on his table these days. We can aim for a "small budget" project. This means, the ASAM Office can contract someone without the TSC. But this is of course in Ben's hands. I will bring this up again, probably tomorrow or on Friday.

Topic is not closed, I try to find a solution.

florianwallerer avatar Feb 12 '24 15:02 florianwallerer

@PhRosenberger can you have a look, what our new ASAM Technology Manager Yash created, so we can bring it to the CCB then. https://github.com/OpenSimulationInterface/open-simulation-interface/commit/e0b9eb94c3fe7c652c979304b04b5632aea96ae5

florianwallerer avatar Feb 22 '24 10:02 florianwallerer

Has been adressed by OpenSimulationInterface/osi-documentation#73.

pmai avatar Apr 05 '24 21:04 pmai