== General ==
{F4420, layout=right, float}
- By downloading swift you agree with the terms outlined [[ https://datastore.swift-project.org/page/legal.php | here ]]
- The swift release cycle is: [[ help/alpha/jenkinsdownload/ | developer builds ]] -> alpha versions -> public beta -> stable
- the swift alpha program allows access to development versions of swift, this means you will use the **versions clarified for tests"**
- please stay calm and patient if you face problems and discuss them with the developer team. For direct questions we have the [[/Z1 | "alpha chatroom"]] (login/registration required)
- [[ Contact ]]. Please enable emails from `swift-project.org` and `swiftnoreply(at)gmail.com` for notifications
- Understand [[help/installation/download/ | which version to download]] and check [[help/installation | installation hints]] before you install. You can check what is new in each individual version here: [[ help/alpha/status/ ]]
- Check the [[ help/alpha/qa | QAs ]]
- The //swift// ecosystem: [[ misc/swiftecosystem/ ]]
== Register ==
IMPORTANT: Please contact us upfront before you register. We will start with a very small number of users and gradually increase the user base. This is about a coordinated testing, not just playing around.
=== Register account for alpha channel/datastore ===
{F5094, layout=right, float} {F5093, layout=right, float}
- If you are a VATSIM user: [[https://datastore.swift-project.org | Register for SSO (Single-Sign-On)]] with your VATSIM account, then you can use your VATSIM credentials with the swift mapping database. After you have registered [[https://datastore.swift-project.org | here (SSO)]] a swift admin will approve your account.
- Problems [[help/alpha/qa/#i-cannot-login-with-with | with VATSIM SSO ]] ?
- Otherwise use the [[/Z1 | "alpha chatroom"]] to request an account
- You can register your email with swift datastore to allow a reset of your password and receive notifications. However, as best practice we advice you to use a secondary email in case something goes wrong (but this general advice is true for all public services and not swift only).
=== Download alpha ===
- To download alpha you need to go here: https://datastore.swift-project.org/page/alpha.html
- Click on the alpha screen and continue
- Login with your VATSIM SSO account (see [[ #register | previous step ]])
-- If already approved, you see the download page
-- If not, you'll see an info that your account awaits approval
-- If your VATSIM experied, get that fixes, [[help/alpha/qa | see here]]
=== Register with Phabricator ===
- Here in Phabricator you can file bugs reports, request features etc.
- Read the [[ registration | registration policy ]]
- If not already done, register with Phabricator (this is where you are right now) by pressing the login button. Unfortunately this site does not support SSO with VATSIM yet.
== Testing stages ==
We will test the software in several stages. Please do not use parts not yet released for testing.
<table>
<tr>
<th>stage</th>
<th>date</th>
<th>purpose</th>
<th>req. skills and prerequisites</th>
</tr>
<tr>
<td>M3</td>
<td>spring 2018</td>
<td>Test on smaller flight networks, gnd. flag and XPlane improvements</td>
<td>small test team outside VATSIM</td>
</tr>
<tr>
<td>M2</td>
<td>mid August 17</td>
<td>test distributed DBus environment for pilot client</td>
<td>mostly a developer team test</td>
</tr>
<tr>
<td>M1</td>
<td>end April 17</td>
<td>test [[ help/smt/ | mapping tool]] and installation, create mappings for tests and future users</td>
<td>understand [[help/mm/ | model matching]], understand aircraft ICAOs, no programming skills needed, English as team language. Please [[help/smt/ | watch the tutorials]] before you start</td>
</tr>
</table>
# Testplan M3
## Improve interpolation
## Improve gnd. flag handling with various clients, also non VATSIM clients
## XPlane improvements driver/QT library
# Testplan M2
## Connect to network with DBus client
## monitor simulation with DBus client
# Testplan M1:
## Misc:
### **Do not fly on VATSIM yet, pilot client needs still improvements**
### Set you a goal: Try to do at least 100, or better 2500 mappings. This sounds a lot when you have done the first 10, but the author has done couple of 1000s. You find your way to simplify the task. So you can select all aircraft of an airline and a distribution, then assign those values in 2 simple steps.
### Do not give up when you find a bug. Report it and carry on unless it is a showstopper.
## Watch the mapping tool YouTube videos as introduction
## Download and install swift from the alpha channel
## Start the mapping tool
## Load your own models into the mapping tool
## Understand filtering
## Now pick a model not yet in the database and try to create a mapping
## Publish this model. Try to publish at least 10 models.
## Once we see you got the idea, we might upgrade your role, you can then directly update into the DB, not only create change requests
## Carry on, pick you favorite AI package, and do as many mappings as you can