Contributor Guide

Constructive contributions to this wiki are welcomed and encouraged. After all, it is a wiki. However, to help keep the site manageable, it would be useful to follow some simple and easy guidelines when making updates and uploading images to this wiki. Here's a help link for new contributors.

### Textual Updates

If you see something that is incorrect, in need of clarification or out of date, you can make updates to text as needed. Textual updates are fairly straight forward. Prior versions of pages are kept in case a rollback is needed.

### Image Updates & Uploads

The preferred image format is webp. However, if you are unable to work with the file type, jpg or png formats can be used. Admins reserve the ability to change your image upload to webp format if needed.

Image sizes are determined by the amount of detail that needs to be shown but keep in mind that very large images take longer to display. If a larger image is needed, consider using a thumbnail or smaller image on the page then allow the user to click on it to view the full sized image.

#### Jersey Images

As the jersey page is one of the more popular pages, please try to conform to these guidelines if you can.

* Use webp format (if possible) however jpg or png will suffice
* Jersey images with full size riders are uploaded at 900x900px but shown in the table centered in the column at 300px
* Jersey images of just the jersey icon are uploaded approximately at 200x200px but shown centered in the table in the column at 180px (default thumbnail size)
* When uploading a new jersey image and placing it in the column, be sure to add the same jersey name of the file in the 'Alternate Text' field. This helps search engines find the jersey image.
* After successfully uploading a new jersey image, please edit the image file itself and add the 'Jersey' category to it. This will insure that your new image is included on the 'index of jerseys' list.
* If replacing an existing jersey image, please try to update the existing image version as opposed to uploading a brand new image. If the image format is different, then upload it as a new image or change the format to match the existing image so you can update it.
* When deciding on the name of the jersey image file, please use same name as is used in Zwift. For example, if the jersey icon in Zwift names it 'Precision Hydration and Fuel' then your image should be named the same. Please avoid added descriptors like 'large, small, date, time, etc'. If you run into a naming conflict when trying to upload, then append the year to the name. For example, the name 'Chasing Cancellara' is used already but a new jersey with the same name becomes available, then you would use 'Chasing Cancellara 2022'. Since people can use the name index to find jerseys, proper naming allows people to find them when searching.

### New Pages

If need to create a new page, please use a concise name that accurately describes the content of that page. In order to be found, the new page needs to be linked to from another page or added to the menus.

### Menus

Menus are an admin function. If you think something needs to be added to the menu structure, please contact an active admin to have it added. However, you should be aware that the menus are constricted by Fandom. The first menu level is limited to 4 items (already all used). the second menu level is limited to 7 items and the third level is limited to 10 items. Therefore, menu space is at a premium and should only contain high level groupings.