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
- AmpersandTarski organization and
- Ordina A-team.
Above links only work for members of AmpersandTarski
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.
- Membership Microsoft Teams project Project A & NUT-Vluchtelingen open source .
- Owner permissions on that project (seems to be current practice).
- Tagged as AmpersandTarski A-team (facilitates initiating chats).
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.
Make sure to work in the documentation branch while creating or editing documentation to prevent unnecessary usage of the pipelines.