Skip to main content

Onboarding

Welcome to the Ampersand team!

Below you wil find a list of activities to get a new contributor up-to speed with Ampersand development.

  • Schedule a meeting with Stef Joosten to get an explanation and demo about the Ampersand project.
  • Contact Han Joosten for the following options to get access to the full ampersand project.
    • Join the upcoming sprint review meeting to meet the team.
    • Request access to the GitHub repository as described below.
    • Get invited to the different sprint meetings through teams as described below.
  • Clone the needed repositories described below

GitHub memberships

Ensure you have a GitHub account. This can be a 'professional' account connected to your Ordina email or any other account.

Request membership to

Above links only work for members of AmpersandTarski

tip

Make sure when you contact Han about this that you provide him with your Github account name (or URL to your GitHub profile page).

Microsoft Teams memberships

The Ampersand team members and also some old members can be found in the teams group channel.

Meetings

Request invitations to the regular (Microsoft Teams) meetings.

These are currently:

  • NUTwente/Ampersand wekelijkse overleg; every monday 11:30, 1 hour.
  • Daily standup; tuesday till friday 11:30, 30 minutes
  • A-team: Sprint review; at end of sprint, friday 9:00, 50 minutes
  • A-team: Sprint retrospective; at end of sprint, friday 10:00, 50 minutes
  • A-team: Sprint planning; at end of sprint, friday 11:00, 50 minutes

Github workflow and info

To work on the project you wil need a local version of the different repositories depending on what you are going to work on. Below is a short description of all the different repositories and what they are used for.

Ampersand

The ampersand repository contains the ampersand application that compiles and builds ampersand applications.

Prototype

The prototype repository makes sure that a ampersand application has a visual interface for the user to interact with your applications.

RAP

The RAP repository is an ampersand application that can be used to create a new ampersand application. This app is mainly used by the Open University of the Netherlands in the course Rule Based Design.

AmpersandTarski.github.io

The AmpersandTarski.github.io repository is used to create the docusaurus documentation webpage. It pulls the different documents from the docs folders of all the repositories. While working this way we need to make sure to work in the correct docs folders.

For Example a document that references or is meant for RAP needs to be in the RAP repository docs folder.

info

Make sure to work in the documentation branch while creating or editing documentation to prevent unnecessary usage of the pipelines.