github/endurain
1
1
Fork 0
mirror of https://github.com/joaovitoriasilva/endurain.git synced 2026-01-09 15:57:59 -05:00
Code Issues 45 Packages Projects Releases Wiki Activity

Improving gear import documentation with many notes.

Browse Source
This commit is contained in:
Marc @PDev1 server
2025-09-14 08:38:35 +00:00
parent b34ebd4e3b
commit b2758bbf69
1 changed files with 16 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
docs/getting-started/advanced-started.md
View File

@@ -119,6 +119,8 @@ To perform an import of bikes:
Ensure the file is named "bikes.csv" and has a header row with at least the fields 'Bike Name', 'Bike Brand', and 'Bike Model'.
Note that Endurain does not allow the "+" character in gear field names, and thus all +'s will be replaced with spaces.
#### Shoe import
At the present time, importing shoes from a Strava bulk export is implemented as a beta feature - use with caution. Components of shooes are not imported - just the shoes themselves.
@@ -131,9 +133,21 @@ To perform an import of shoes:
Ensure the file is named "shoes.csv" and has a header row with at least the fields 'Shoe Name', 'Shoe Brand', and 'Shoe Model'.
Note that Strava allows blank shoe names, but Endurain does not. Shoes with a blank name will thus be given a default name of "Unnamed Shoe #" on import.
Note that Strava allows blank shoe names, but Endurain does not. Shoes with a blank name will thus be given a default name of "Unnamed Shoe #" on import.
Endurain does not allow the "+" character in gear field names, and thus all +'s will be replaced with spaces.
#### Notes on importing gear
NOTE: There is currently no mechanism to undo a gear import.
All gear will be imported as active, as Strava does not export the active/inactive status of the gear.
Note that Endurain does not allow the "+" character in gear field names, and thus all +'s will be replaced with spaces on import.
Endurain does not allow duplicate gear nicknames, regardless of case (e.g., "Ilves" and "ilves" would not be allowed). Gear with duplicate nicknames will not be imported (i.e., only the first item with a given nickname will be imported).
The import routine checks for duplicate items, and should not import duplicates. Thus it should be safe to re-import the same file mulitple times. However, due to the renaming of un-named shoes, repeated imports of the same shoe file will create duplicate entries of any unnamed shoes present.
Gear that is already present in Endurain due to having an active link with Strava will not be imported via the manual import process.
### Importing other items from a Strava bulk import