Vianordis
--:--:-- UTCVianordis / SUPPORT
documentation

Kognis

Available

Kognis is the internal documentation space for runbooks, procedures, decisions, and team knowledge. Authors can write in markdown, organize pages by area, control access, and keep versioned history for operational reference.

Verified user manual

Kognis user manual

Find, create, structure, revise, and govern internal knowledge in the Kognis 2.0 wiki.

Manual
Version 1.0
Product
Kognis 2.0.0
Verified
July 15, 2026
Language
English · Source
Owner
Kognis product and support
Source
kognis · 849e8c6a
Review cycle
90 days
Start here

Audience, scope, and prerequisites

Covers Kognis page reading, search, Markdown editing, navigation hierarchy, assets, history, and role-controlled administration. Server, database, storage-target, and authentication-provider administration are excluded.

Who this is for

  • Knowledge readers
  • Authors and reviewers
  • Wiki administrators

Before you sign in

  • A Kognis identity in the correct tenant
  • An agreed page location, owner, review date, and audience
  • Approval and rights for attachments or media
Access model

Roles and responsibilities

RoleAccessResponsibilities
ReaderRead and search pages and permitted assets.
  • Use current approved guidance
  • Report stale or unexpectedly visible content
AuthorCreate and edit pages and upload assets where path rules allow.
  • Use the existing hierarchy
  • Cite sources and maintain ownership
AdministratorManage navigation, groups, permissions, locales, and system configuration.
  • Preserve least privilege
  • Test access rules before broad publication
Workspace map

Navigation

Home

/

Open the tenant knowledge homepage.

Search

/_search

Find pages using text and enabled semantic search.

New page

/{path}

Create a missing page at an authorized path.

History

/h/{path}

Review page versions when permitted.

Assets

/_assets

Use uploaded images and files through the editor.

Administration

/a

Manage the wiki when system permission is assigned.

Chapter 01

Find and plan knowledge

Search and browse the hierarchy before creating a page so one authoritative source remains easy to discover.

Procedure 1.1

Find authoritative content

Use navigation and search, then verify ownership and recency before relying on a page.

  1. 1
    Browse the hierarchy

    Start from the relevant space or parent topic in the sidebar.

  2. 2
    Search with specific terms

    Use product names, task phrases, error text, and known titles.

  3. 3
    Open the best result

    Confirm path, tenant, audience, owner, and related pages.

  4. 4
    Check recency and history

    Review the page metadata or history when the decision depends on current guidance.

  5. 5
    Report ambiguity

    Ask the owner to consolidate conflicting pages rather than choosing silently.

Expected result

The reader identifies one current, authorized page or records that authoritative guidance is missing.

Procedure 1.2

Plan a new page

Choose a durable path, audience, owner, and structure before opening the editor.

ForAuthor
  1. 1
    Search for overlap

    Check alternate terminology, acronyms, and neighboring paths.

  2. 2
    Choose the parent path

    Place the page under the relevant product, team, or process hierarchy.

  3. 3
    Define purpose and owner

    State who the page serves, what decision or task it supports, and who maintains it.

  4. 4
    Gather approved sources

    Use authoritative policies, code, release information, or owner decisions.

Expected result

The planned page has a unique purpose, durable location, responsible owner, and approved source set.

Chapter 02

Author and publish pages

Write task-oriented content with clear headings, links, and evidence; do not use the wiki as an uncontrolled file dump.

Procedure 2.1

Create or edit a Markdown page

Use the enabled editor and complete page metadata before saving.

ForAuthor
  1. 1
    Open the intended path

    Navigate to the missing path and choose Create, or open an existing page and choose Edit.

  2. 2
    Set title and metadata

    Confirm locale, path, description, visibility, and any publish timing fields.

  3. 3
    Write structured content

    Use one page title, ordered headings, concise steps, meaningful links, and accessible tables or lists.

  4. 4
    Preview

    Check Markdown rendering, links, code blocks, images, and narrow-screen readability.

  5. 5
    Save with context

    Use the available description or change message to explain the update.

  6. 6
    Verify the page

    Open the rendered path and check sidebar placement and permissions.

Expected result

The page renders at the intended path, is visible only to its audience, and has a traceable version.

Procedure 2.2

Upload and insert an asset

Use a controlled folder, durable filename, and accessible description.

  1. 1
    Open the asset picker

    From the editor, browse the existing asset hierarchy.

  2. 2
    Search before upload

    Reuse an approved current asset when possible.

  3. 3
    Choose the folder

    Place the file under the appropriate product or topic path.

  4. 4
    Upload the prepared file

    Use a stable filename and verify type, size, rights, and removal of unnecessary metadata.

  5. 5
    Insert and describe

    Add meaningful alternative text or link text and verify rendering.

Expected result

The asset exists once in an authorized folder and is referenced accessibly from the page.

Chapter 03

Review history and govern access

Use history for traceability and apply permissions to paths and groups with explicit tests.

Procedure 3.1

Compare or restore page history

Identify the intended revision and restore it through a new traceable change.

  1. 1
    Open History

    Use the page history action when your permissions allow it.

  2. 2
    Review revision metadata

    Compare author, time, action, title, path, and content.

  3. 3
    Select the recovery point

    Confirm it contains the desired state and no outdated policy.

  4. 4
    Restore or edit

    Use the supported restore/edit flow and describe why the content is being recovered.

  5. 5
    Verify permissions and links

    A historical version may contain paths or references that are no longer valid.

Expected result

The recovered content is published as a traceable current revision and remains valid under present policy.

Procedure 3.2

Change page or path access

Use groups and path rules to implement the least access required.

ForAdministrator

Before you begin

  • Approved access change with affected paths and test identities
  1. 1
    Identify effective scope

    List the exact path, descendants, locale, groups, and required read/write/history/asset permissions.

  2. 2
    Review existing rules

    Account for inherited allow and deny behavior before adding a rule.

  3. 3
    Apply the smallest change

    Grant only the required permissions to the approved group.

  4. 4
    Test allowed access

    Use a representative authorized account to verify required actions.

  5. 5
    Test denied access

    Use a representative unauthorized account to confirm content, history, source, and assets remain protected.

Expected result

Authorized users can perform required actions and unauthorized users cannot discover or retrieve protected content.

Operating rules

Security and data handling

  • Place content in the correct tenant, locale, and path.
  • Use groups and path rules rather than sharing credentials or public links.
  • Protect page history, source, assets, and search results as well as the rendered page.
  • Do not store secrets or unnecessary regulated data in wiki pages.
  • Review AI-assisted edits and semantic answers against authoritative sources.
Current release

Known limitations

Read before relying on an unsupported workflow

These limits describe the source-pinned Kognis 2.0.0 scope and must be rechecked when the product changes.

  • Available editors, search engines, semantic search, and AI features depend on administrator configuration.
  • Page history and source access require separate permissions.
  • Assets follow path and role checks and may not be accessible to every page reader.
  • Restoring old content does not make old links, policy, or attachments current.
Problem solving

Troubleshooting

You cannot sign in to Kognis

Likely cause: The session expired, the identity is not assigned to the application, or the tenant claim is missing.

  1. Open the application from the approved portal and complete sign-in again.
  2. Confirm that the correct organizational identity and tenant are selected.
  3. If access is still denied, record the time and request an entitlement check from support.

A documented action or navigation item is not visible

Likely cause: The current role, release, tenant configuration, or feature flag does not expose that operation.

  1. Confirm the role and prerequisites listed for the procedure.
  2. Reload the page after signing in again; do not attempt to bypass the interface through direct URLs.
  3. Ask the product owner whether the feature is enabled for the tenant before reporting a defect.

A saved change or background operation is not visible

Likely cause: Validation failed, processing is still running, or the current view is stale or filtered.

  1. Review inline validation, status indicators, filters, and the selected tenant or workspace.
  2. Refresh once and search for the item by its stable name or identifier.
  3. Do not repeat irreversible or externally visible actions until the original operation status is known.

A page is missing from navigation but opens by URL

Likely cause: The page exists but the navigation tree, locale, group visibility, or cache does not include it.

  1. Confirm page path, locale, and publish state.
  2. Review navigation rules and group scope.
  3. Do not duplicate the page solely to make it appear in the sidebar.

Search does not return a known page

Likely cause: The page is not published or readable, indexing is delayed, or search terms differ from the content.

  1. Open the page directly and confirm permission and publication.
  2. Search exact title and distinctive body terms.
  3. Ask an administrator to review indexing only after access is confirmed.
Escalation

Contact support

Contact support when

  • A repeatable Kognis error blocks an approved workflow
  • Expected data, permissions, or tenant boundaries appear incorrect
  • A security, privacy, compliance, or data-loss concern is suspected
  • Conflicting pages cannot be consolidated safely
  • A permission or search result may expose protected content

Include

  • The page, action, and expected result
  • The exact error text and time of occurrence, including time zone
  • Your tenant, role, browser, and a sanitized record or item identifier
  • Whether the problem can be reproduced and which troubleshooting steps were tried

Never include

  • Passwords, access tokens, API keys, recovery codes, or session cookies
  • Unredacted personal, health, financial, or other regulated data
  • Private encryption keys or complete confidential documents unless an approved channel is provided
Contact support