Add some descriptive documentation about osgi-test HOT 6 OPEN

Hi @laeubi , thanks for the feedback!

Have you seen the documentation in the readmes? See here: https://github.com/osgi/osgi-test

Maybe we can do a better job of linking it to the rest of the doc.

Also, some of your questions seem to go a bit beyond the scooe of the osgi-test library and are more directed at writing code/tests under OSGi in general. Perhaps we could link to relevant sources as prerequisites.

from osgi-test.

Have you seen the documentation in the readmes?

Yes but those are more examples that already "jump into the topic", just as an example there is no direct hint:

1. what maven dependencies are required?
2. what is the current released version?
3. Can I run my tests inside the module under test?
4. Do I need BND / RCP /... to run my test or is surefire enougth

While this might be obvious for people using osgi-test already its hard for newcomers, and for sure some things a more generic but it would help to have something like https://github.com/junit-team/junit5-samples/blob/r5.8.2/junit5-jupiter-starter-maven/pom.xml for example as a (linked) reference, so lets say I have no idea about juni5 I can still copy the pom and at laest know that all dependencies are set.

To stay with this example JUnit 5 has a quite descriptive overview for beginners here:
https://junit.org/junit5/docs/current/user-guide/

So I can get a fast overview about the What/How and some links that directly guide me to more detailed aspects.

from osgi-test.

This issue has been automatically marked as stale because it has not had recent activity. Given the limited bandwidth of the team, it will be automatically closed if no further activity occurs. If you feel this is something you could contribute, please have a look at our Contributor Guide. Thank you for your contribution.

from osgi-test.

Still only dummy content on that site, examples are hard to understand and fragmented documentation.

In the meanwhile i learned junit seem to use asciidoc for their documentation what gives a really nice looking result and can easily be deployed to github pages.

from osgi-test.