How to use the JustOn documentation?

JustOn offers a suite of software to automate financial processes – including billing and invoicing, payment management, accounts reconciliation and bookkeeping support. The JustOn documentation provides comprehensive guides to help you start working with the software. At a first glance, the extent of the documentation may seem overwhelming – so here is a short guide on how to navigate it.

General Structure

Basically, the JustOn documentation takes a role or intention-based approach. This makes the first structuring level:

Overview & Concepts: Introduces topics, discusses ideas, describes workflows, etc. → explains to learners how things work
Operation: Provides instructions for users on how to accomplish daily business tasks (in English, German and Frech) – managing and processing actual business data
Setup & Configuration: Provides instructions for administrators on (usually one-time) setup and configuration tasks → how to enable a feature, how to change the software behavior, etc.

On the second level, you will find the "functional areas" covered by JustOn software – the same in all role-based domains:

Billing automation
Invoice management
Receivables/payables
Bookkeeping

Combining these structuring approaches makes up the following general topic organization:

documentation structure

So ask:

What type of information do I need?
- An explanation → Overview & Concepts
- Help on a daily business task → JustOn Operation
- An instruction on how to set up a feature → Setup & Configuration
To which functional area does my topic belong?

Open it, and drill further down to find your topic.

Using the Search

The JustOn documentation provides a client-side full-text search.

Note

The search works completely separate in each of the role-based domains.

The search is powered by Lunr, a Javascript search library, which is included with MkDocs/Material for MkDocs – the site generator that builds the documentation.

As the name suggests, Lunr is not as bright as Solr (or other large search engines), but it is small, fast and privacy-compliant. And some convenience is still built in:

Search term combination

The search combines multiple search terms with OR by default. So searching for direct debit in the Concepts domain, for example, produces all pages that contain either direct alone, debit alone or both direct and debit anywhere on the page.

For an AND search, enclose the search terms in double quotes, like "direct debit". Try "direct debit" – this will produce only the pages that contain both direct and debit anywhere on the page.

You may expect terms in quote signs to execute a search for the exact phrase, but Lunr does not support span queries. So the best you can achieve is an AND search.

Wildcard search

For a wildcard search, use * to replace any zero or more characters anywhere in a search term.

Title search

To restrict the search to page headings or section headings, add title: to your search term. That is, to search for all sections whose headings include "payment", type title:payment. See the result: title:payment.

Tags

Most searches will produce more than one result. So you still must decide which result is the most relevant for you. Enter tags: they indicate the context of a search result, which helps you determining its relevancy. These tags are available:

Context	Tags
Product	`billing & invoice management` `cash management` `schufa` `datev`
Information Area	`reference` `integration`

Info

If you are not happy with the search results produced by the built-in search, try your favorite web search engine restricted to the JustOn documentation – using the site operator, followed by your search terms, like site:docs.juston.com "direct debit".

Try it on