Public Facing

General

• structure Wiki

  • Restructure the documentation landing page: Documentation (developer, implementer, user)

  Sandbox Landscape : User documentation:

  • Provide near time status updates for Sandbox Landscape : Status monitor page for demo instance has been added, outstanding for others

  • Reorganize Release Notes - Releases

  • ➡️ SEO for the Wiki and the Website - Communication

  • 🧑‍🏭 Rework wiki “Spaces”

• Rework wiki “Space Shortcuts”

Wiki Target Structure

• openIMIS Product

  • Demo server / Sandbox Landscape

  • Releases

    • Release 2022-04

      • Sources Release 2022-04

      • Release notes

    • Release 2021-10

      • Sources Release 2021-10

      • Release notes

    • Release 2021-04

      • Sources Release 2021-04

      • Release notes

  • Installation guide

    • Requirements

      • Connectivity & theoretical infrastructure required

      • Resource requirements

      • Infrastructure security

    • Generic Implementation Starter Kit

    • Installation and Country Localisation

    • Configuration (choosing Modules)

    • Localisation / Translation Management platform

    • Customization (configuring/extending Modules)

    • Import tools

    • “How to migrate from Legacy to Modular” ↔︎ (see Modular Migration: Open Issues )

    • Training / YouTube

  • Architecture

    • Use cases served by openIMIS - overview

    • Target Technology Stack / (new) openIMIS installations

    • Modular Transformation / openIMIS Modules/ Target (modular) Architecture / https://docs.google.com/presentation/d/1eUqlOkK6MyTPZsQG3A8mZDzoIvFxzUtxi5r6UCVYYjc/edit#slide=id.g1192d288ca2_0_65 (slide 12)

      • The JLN Process Matrix

      • JLN Process - OpenIMIS Mapping

      • Dependency Graph for Modules / repos

    • openIMIS Database Design

    • openIMIS Integrations

    • /wiki/spaces/SB/pages/3244916739

  • Software Development

    • code and publishing management

      • Version management

      • Contribution guidelines

      • UI/UX Contribution Guide

      • Extended Github workflow

      • Updating all python modules CI github workflow

      • “Automated CI testing" of code and publishing management

      • Repository management (http://github.com / http://npmjs.com / http://pypi.org

    • Developer Starter Kit

    • Quality assurance

      • Testing

      • Security assessment template

    • Training / YouTube

  • Service Desk

    • Issue tracking

    • JIRA reports

  • Licenses

• openIMIS User

  • FAQ List

  • http://docs.openimis.org/en/latest/ / http://docs.openimis.org/fr/latest/

  • Training / YouTube

• openIMIS Development

  • Product Roadmap

  • Product Incubator

  • Opportunities

  • Project portfolio

  • https://openimis.atlassian.net/wiki/pages/resumedraft.action?draftId=40566854

• openIMIS Community

  • Meet our partners

  • Governance

  • Implementations

  • Communication

Users

• • List of regular wiki maintenance tasks (e.g. update events, opportunities, projects, clean archive …) → Wiki Maintenance

  • Restructure Wiki (Wiki Target Structure [Draft] ) to optimize accessibility to knowledge for different target groups

    • Ensure usability for low resolution devices / old displays (e.g. including links to child pages on every page)

    • Ensure usability for old/slow devices e.g. by reducing the number of unnecessary page loads

  • Ensure, that every page is converted to the new editor

  • ➡️ Provide translations (e.g. in French) of the most important content → communications

    • ➡️ Harmonize multi-language selection/navigation → communication

  • Use custom domain name for the Wiki (wiki.openimis.org)

    • Is currently not supported by the cloud-hosted Confluence Wiki → https://jira.atlassian.com/browse/CLOUD-6999

  • 🧑‍🏭 Report Copy & Paste (Links) Bug

    • https://jira.atlassian.com/browse/CONFCLOUD-74361

• Web-Page

  • Introduce issue queue for web-maintenance → https://openimis.atlassian.net/jira/software/c/projects/OOW/boards/23

  • Maintain /wiki/spaces/SB/pages/1025015809

  • ⚠️ ➡️ cross link language version in wiki-version of the web-page

Users

• Improve user documentation http://docs.openimis.org/en/latest/ / http://docs.openimis.org/fr/latest/

  • which platform for user docs? readthedocs (current standard, but outdated)? gitbook? wiki?

• Updated FAQ List

• Outdated user documentation (Different Styles)

Implementers

• Update and Integrate Installation and Country Localisation into Documentation

• Update Installation and Country Localisation to allow newbies

  • Update user documentation to current cooperate design (use new logo)

  • Links towards the Wiki need to be checked (e.g. “openIMIS Install documentation”)

  • ➿ 🧑‍🏭 Ensure coherency of the linkage between the user documentation and other platforms (like the Wiki or the webpage)

• Update FAQ List

  • Remove usage of featured FAQ lists outside of the website sandbox

  • Move to Sandbox

Implementers

• Validate and Integrate Installation Guide into Documentation

• Update Installation Guide to allow people that are interested to quickly setup the current version in the supported environment (Linux & PostgreSQL)

  • 🧑‍🏭 Variations as “Implementers Experience reports” as link out from the standard installation instruction e.g. “see other

• 🧑‍🏭 Clean up naming: “modular” is default case and doesn’t need to be especially designated as such for the purpose of Documentation , “legacy” is special case, its content need to be updated/removed/archived to reflect the new reality - E.g. in Installation and Country LocalisationGuide - This also needs to be reflected in documentation within the (GitHub) repositories

• Update Validate and Integrate Generic Implementation Starter Kit into Documentation

  • Update Resource requirements

• Integrate further mature/non-development content into Documentation

• Describe Configuration/Customization (per module) in Documentation ↔︎ Dev Committee #288

  Update Demo server to latest version (currently 1.1.3)

  Jira Legacy
  server System JIRA serverId 97d38f4a-4cd9-3563-900d-60c9290b47f4 key OSD-179

  Document versioning - How to maintain a visible “main version number” and organize versions for modules while inter-module-compability can be understood

• Create “How to migrate from Legacy to Modular” in https://openimis.atlassian.net/wiki/spaces/OP/pages/3286204427 (see Modular Migration: Open Issues)

• Cleanup Create “How to update from version / release x to version / release y” tutorial

• ValidateQuality assurance and Document Testing Scenarios ↔︎ Dev Committee #223

• Update Validate and Integrate openIMIS Integrations into Documentation

• Update Validate and Integrate Sandbox Landscape into openIMIS Product

• Update Validate and Integrate Translation Management platform into Documentation

• Cleanup Validate and Integrate JIRA reports into openIMIS Product

• Cleanup Validate and Integrate Issue tracking into openIMIS Product

• Update Validate and Integrate Use cases served by openIMIS - overview into Documentation

Developers

Development guidelines

• Update Developer Starter Kit for Release 2022-04

• 🧑‍🏭 Update Installation

...

• Guide for Release 2022-04

• ⚠️ Create “Technical Requirements” page and fill with content e.g. Connectivity & theoretical infrastructure required

...

• Validate and Integrate code and publishing management into Documentation

...

• • Validate Version management

...

• • Validate Contribution guidelines

...

Create “UI/UX Contribution Guide”

• • Validate Extended Github workflow

  • Integrate Updating all python modules CI github workflow into

...

• • Documentation

  • Integrate “Automated CI testing" of code and publishing management into

...

• • Documentation

• ⚠️ Validate and integrate UI/UX Style Guide into Documentation

• Validate YouTube content for Release 2022-04 / current development ↔︎ Dev Committee #176

  • Merge YT-Playlists https://www.youtube.com/playlist?list=PLWKJKsJBiT3I0kPxDEjiOpT6_sX01pl3Q and https://www.youtube.com/playlist?list=PLWKJKsJBiT3LlFCac1D7yQqj-AbSGD4ic

• Validate and update Functional specification / Technical documentation

• Integrate code documentation in Wiki (see 2022-07-28 Developers Deep Dive Call )

• Setup a “Source Code Opportunities” page where software solutions of projects like Project: MARS Software Lab, the solution of Bluesquare in Nepal or other prototypes / proof of concepts can be put, maintained and referred to, to be taken up and being further developed

Github

• Clarify distribution of

...

• documentation between GitHub repo and Wiki and remove redundancies

• Clarify distribution of release notes between GitHub repo and Wiki and remove redundancies

• ⚠️ Mark/Remove/Hide deprecated GitHub repos

• Provide license information in every repository

Architecture

• Rework/create documentation of modular architecture Modular Architecture [Notes]

• Reorganize structure in openIMIS Modules and create overview according to The JLN Process Matrix / JLN Process - OpenIMIS Mapping / https://docs.google.com/presentation/d/1eUqlOkK6MyTPZsQG3A8mZDzoIvFxzUtxi5r6UCVYYjc/edit#slide=id.g1192d288ca2_0_65 (slide 12) ↔︎ Dev Committee #105

• Create dependency graph for openIMIS modules / repos in Documentation

...

• Validate and Integrate Modular Transformation (e.g. Target (modular) Architecture ) into Documentation

...

• Validate and Integrate Target Technology Stack into Documentation

...

• Validate and Integrate (new) openIMIS installations into Documentation

...

• Validate and Integrate JLN Process - OpenIMIS Mapping into Documentation

...

• Validate and Integrate openIMIS Database Design into Documentation

• Update each module in openIMIS Modules

  • Create a link to the code documentation ↔︎ Dev Committee #260

...

• • Clarify options for configuration and/or customization of a module ↔︎ Dev Committee #274 and #288

• Validate and Integrate finished Projects from Project

...

• Portfolio into Documentation (Architecture)

Release

• Document Release Management into Documentation

...

• • Step by step deliverables / check-list (integrate pull-requests, update doku, update modules overview) ->Checklist for Release 2022-10

• Update Sources for https://openimis.atlassian.net/l/c/9WjwwJwE and optimize accessibility

• Integrate Sources into Releases

• Merge / move / clean up Release notes into Releases

• Setup / optimize a documentation update process (checklist) to ensure the documentation improves in a timely and parallel way

Documentation Methodology

• ⚠️ How to document architecture: Graphics: repository for architecture etc done with draw.io

  • /wiki/spaces/SB/pages/3244916739

• Re-organize first level children of Documentation e.g. create and move content into

...

• our Technical Knowledge Base as “How-to”

...

• Validate and Integrate further mature/not-in-development content into Documentation

• Standardize naming in

...

• our Technical Knowledge Base “How to” etc. …

• Standardize naming in openIMIS Product substructure

...

• explicitly “openIMIS” everywhere or nowhere

• Include Domain Knowledge into Wiki Target Structure [Draft]

• Setup Process for Transform Product Owner / Incubator Knowledge to Documentation

• Setup Framework to Improve Recording, Documentation and Publishing of Webinars

  • Enable the process to be started externally (e.g. per Jira queue)

Internal Documentation

...

Under Maintenance Contract

• Project: 2020.T1 Maintenance

...

• Sandbox Server access / root accountkeypass

• Consolidate server hosting credentials, migration of DNS host and access sharing strategies -> Server Administration & Accounts

• Clean up DNS Records

• Keypass keyrings:

  • admin Admin (on internal teams channel)developers (on Google drive?)

  • Others on demand

GIZ internal

• server Server contract login (keypass Keypass keyring)

• DNS is still on cloudflare → Hetzner

• web Web-page - wiki links: Incoming links from openIMIS.org Wiki links: /wiki/spaces/SB/pages/1025015809

• Remove / document / avoid content redundancies between web and wiki

• ➡️ Make sure the transition from web to wiki Wiki is smooth (especially for first time users) Analyze backlinks

• 🧑‍🏭 Clean up Teams channels (List, messages, export)

• Analyze back-links from Wiki to Web - e.g. Chad (and other implementations) refers to http://openimis.org/tanzania on the web

• ➡️ Publish relevant Events on Web

• Remove [delete] Welcome to the openIMIS Initiative! and other redundant content after launch of new version of Web

Guiding Principles

• Separate static from temporal content

• Remove and avoid redundancies

Taskforces