Skip to content

Help people understand basic configuration and monex #101

@duncdrum

Description

@duncdrum

What is the Problem

OOTB, the only thing that new users have to decide is an admin pw (trivial) and the memory and cache configuration for their instance (far from trivial). I learned this as trible knowledge passed on from experienced eXist-db devs. Enter monex, for the cache settings we now have this:

screenshot 2017-03-15 13 03 47

But there is no documentation how to interpret it, after a couple of years, I barely understand 40% of whats going on in this panel.

Solution

Rewrite the configuration guidelines, so that people can make more effective use of monex. What is dom.dbx, and where can i see it? Should I be worried that my collection cache isn't full? How many fails are ok?

I realize that there is no simple one size fits all answer to how to set the basic memory config parameters, but i feel that the documentation could do a much better job at helping users get help, by talking about how monex displays relevant information for the topics which are otherwise hidden in different parts of the documentation.

Any core devs takers?

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions