| Word | Meaning |
|---|---|
| Event | One of the parts of a meet (eg. 50m Freestyle). An event can be qualified using tags (eg. 50m Butterfly, Male, Over 50s). |
| Discipline | A swimming discipline, eg. Freestyle, or Breaststroke. |
| Handicap | A way to make swimmers finish a race almost at the same time. Faster swimmers are handicapped to start later than slower swimmers based on previous swim times. |
| Heat | An event might have more people entered into it than can swim at once. In this case, the even is split into heats (and sometimes finals). |
| Meet | A swim meet is a collection of events, typically held on one day. |
| Nominal handicap | A swimmer’s expected time to complete an event, based on historical performance. |
| Race handicap | A delay between the start of a heat and when a swimmer should begin swimming. When well handicapped, a heat might finish with several swimmers touching the wall at almost the same time |
| Scratch | A type of event that has no handicaps applied. Everybody starts at the same time. |
| Tag | An annotation to an event. |
Just keep swimming is a web-based app to manage an amateur swimming club. To access the app, you must first be enrolled into the system. Use your account credentials to login.
To log out of the system, click on your email address in the top-right of the screen, and select Log out.
Most of the tables in Just keep swimming use similar design shortcuts:
The following sections comprise Just keep swimming. Click on the heading at the top of the page to navigate to that functionality.
This section contains the User Guide for the software - you are reading it!
This section allows you to manage meets:
Create a new meet by editing the top row of the Swim meets table. A meet consists of a Date, a Name and a Season. Currently, Seasons are hardcoded into the system, and you can choose a season from the drop-down. Note that the latest season is the default. Adding a new meet requires at least a Date and a Season.
The Swim meets table has a series of radio buttons in the first column. Clicking one of the radio buttons selects that meet, with these effects:
A meet can be edited from the table once it has been selected using the radio button.
Use the Meet Events table to add events to the selected meet. In general, most events will have only values for distance and discipline. Use Tags to show an event was limited in some way (eg. Women) or special (eg. Club Championships).
The People table shows club members listed in alphabetical order by surname. You can Add, Edit and Remove people from the system (although I would strongly advise against removing people from the system). Future work on the software might include keeping track of currently active people, or even manage their registration fees, and possibly even checking in before a meet.
Our swim club is paper-based on the pool deck:
Therefore, this page allows configuring and printing event programs for
Selecting a meet from the drop-down displays all events in the chosen meet.
Each event will have people listed in the table. People are shown by default if they have swum in that event in the year preceding the meet. It is possible to add or remove people from the printed program by selecting their name from the “Add or remove:” drop-down immediately below the event’s program.
The swimmers are sorted by their nominal handicap, so that swimmers of similar ability are likely to end up in heats together. Currently, the nominal handicap for a swimmer is the quickest time from their previous results in that event, including results up to a year old.
The role of the Handicapper is to set up heats so that the swimmers finish the race at almost the same time, making for more exciting experiences for swimmers. The Program page shows a view designed to help the Handicapper set handicaps.
Each swimmer is shown with a suggested nominal handicap calculated as the best time for this event in the last year, rounded to the nearest whole second. The nominal handicap value is editable by the handicapper on this screen.
Additional information (visible only on this screen) is provided in columns to the right of the nominal handicap. They are:
When the Handicapper is happy with the program for each event, click the Download PDF button to obtain a printable version of the programs.
The printed program is designed for the pool deck. It shows the swimmer’s name and handicap (in a column headed Expected Time, nomenclature that may change in the future). The table has columns for results entry.
Just keep swimming stores results from all meets and events in one gigantic database table. Loading all of these results would be slow and not very useful. To avoid this, the Results page applies a filter to the results, as specified by the drop-downs at the top of the page. Each drop-down adds an AND clause to the filter - an example query might be: Show me results from Week 3 AND only show results for Brendon.
The results page is for entering and reviewing swim times. When this page loads initially, no results will be visible. Once you start selecting values from the Limit results… drop-downs, results matching those selections load into the bottom table.
To enter new results, a Meet must be selected. New results can be entered in the top row. The adjusted time value is calculated from the Race handicap and the *Time** value. On clicking the ‘+’ button, the new result will be added to the table.
Finally, to print tabulated results for a selected meet, press the Print Meet button. Note that this button is enabled only when a meet is selected. The tabulated values are in a PDF document downloaded by your browser.
| Release | What |
|---|---|
| 0.5.8 | Handicaps are editable by the handicapper |
| 0.5.9 | Bugfix for Issue 13 (programs now show meet correctly |
| 0.6.0 | Show stats in the programs (variance, average etc) |
| 0.6.1 | As you enter results, the table will show them reversed so you can see what you just typed |
| 0.6.2 | Published results have swimmers initials only for privacy |
| 0.6.3 | Add 120m as a race distance (needed for medley) |
| 0.6.4 | Fix PB syntax |
| 0.6.5 | Quicker response on saving result (was reloding all results, now just loading new result and adding it to the table) |
| 0.6.6 | Added +/- column to the results entry, to help pick up errors in data entry |