Description

The idea is to design an Onboarding application that can be used by any project and that we would use on xwiki.org to onboard contributors.

Ideas:

• Home Page:
  • Button to Start the onboarding process. When clicked the user is asked his first and last name and a wiki page is created that will follow his onboarding progress
  • Live Table listing all users being onboarded and their current progress with an action column to "Continue onboarding"
  • Uses an OnboardedUserClass xclass.
• An OnboardingClass xclass to represent an onboarding task. Properties:
  • Title of task
  • Task ID
  • Previous task IDs
• Principle:
  • When a new user onboards, display the first task
  • At the bottom of each task, display a button "Done" or "Show me another task" (+ "Previous")
  • When clicking "Done", if there are several Tasks that have the current Task as "previous task IDs" then ask the user which one he'd like to do. This allows to have several onboarding tracks:
    • onboarding for modifying xwiki.org doc, 
    • onboarding for making modifications to XWiki core
    • onboarding to create a new extensions on contrib
    • onboarding to add translations
    • etc

Example for xwiki.org:

• Idea: Reuse some GCI repeatable tasks as onboarding tasks.
• Task 1.0: Join the community (create account on xwiki.org, log in on forum, register on Riot)
  • Task 1.1.0 (Track 1): Contribute code to Core
    • Task 1.1.1: Install XWiki developer VM: install Virtual Box + import inside VB
    • Task 1.1.2: Build XWiki Jetty/HSQLDB distribution and execute XWiki
    • Task 1.1.3: Make a modification to a file and rebuild, and verify that the change is there
    • Task 1.1.4: Make a modification to a page in the wiki and export it to the source tree
    • Task 1.1.5: Commit + Learn how to create a JIRA issue + Learn how to do a Pull Request with the modified changes
  • Task 1.2.0 (Track 2): Contribute a new extension
    • Task 1.2.1: ...

Manual implementation (without the onboarding app) started here.