<@U6P03BM0W> I'd like your opinion on the Features...

# opensavvy

[CLOVIS]

@dave08 I'd like your opinion on the Features Overview page: https://opensavvy.gitlab.io/groundwork/prepared/docs/features/index.html

I think it's too crowded and complex to read, but I don't really know what else to put there.

[dave08]

I found it pretty nice! I really liked the practical examples of most of the features... I think the first good impression I got from the framework was from that page.

I guess a bit of an improvement could be to separate the basic usages from the other levels of usages, maybe have one section for the most basic and typical uses of the features, and the extra code sections for more and more advanced or less common features.

[dave08]

Like passing the Prepared in the test constructor isn't the typical usage... but might be useful for more advanced situations.

[dave08]

Also, having one of those sections showing top level functions for db setup, wouldn't be in the basic usage section

[dave08]

But launchInBackground cleanUp and random could still be in basic usage w/o overclutter

[CLOVIS]

Like passing the Prepared in the test constructor isn't the typical usage...

Ahah, it is for me! I write test suites for interfaces. I added a page to explain that: https://opensavvy.gitlab.io/groundwork/prepared/docs/tutorials/syntax.html (also useful as a comparison to Kotest since containers work differently)

[CLOVIS]

When I'm done adding the documentation for all features, I want to fill in https://opensavvy.gitlab.io/groundwork/prepared/docs/practices/index.html with generic tricks to make testing easier; if you have any ideas, don't hesitate to create issues in advance 🙂