Skip to content

Commit 7819c2b

Browse files
(Documentation) Use OpenAPI-compatible type names in docs (#1469)
1 parent 2827d11 commit 7819c2b

10 files changed

+451
-427
lines changed

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@
1313
- (Feature) Member Memory Reservation
1414
- (Documentation) Update ArangoDeploymentReplication and ArangoLocalStorage CR auto-generated docs
1515
- (Feature) Add ArangoMember Message and extend ArangoMember CRD
16+
- (Documentation) Use OpenAPI-compatible type names in docs
1617

1718
## [1.2.34](https://github.com/arangodb/kube-arangodb/tree/1.2.34) (2023-10-16)
1819
- (Bugfix) Fix make manifests-crd-file command

docs/api/ArangoBackup.V1.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,25 @@
22

33
## Spec
44

5-
### .spec.backoff.iterations: int
5+
### .spec.backoff.iterations: integer
66

77
Iterations defines number of iterations before reaching MaxDelay. Default to 5
88

99
[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L31)
1010

11-
### .spec.backoff.max_delay: int
11+
### .spec.backoff.max_delay: integer
1212

1313
MaxDelay defines maximum delay in seconds. Default to 600
1414

1515
[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L29)
1616

17-
### .spec.backoff.max_iterations: int
17+
### .spec.backoff.max_iterations: integer
1818

1919
MaxIterations defines maximum number of iterations after backoff will be disabled. Default to nil (no limit)
2020

2121
[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L33)
2222

23-
### .spec.backoff.min_delay: int
23+
### .spec.backoff.min_delay: integer
2424

2525
MinDelay defines minimum delay in seconds. Default to 30
2626

@@ -72,13 +72,13 @@ This field is **immutable**: can't be changed after backup creation
7272

7373
[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L77)
7474

75-
### .spec.lifetime: int64
75+
### .spec.lifetime: integer
7676

7777
Lifetime is the time after which the backup will be deleted. Format: "1.5h" or "2h45m".
7878

7979
[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L47)
8080

81-
### .spec.options.allowInconsistent: bool
81+
### .spec.options.allowInconsistent: boolean
8282

8383
AllowInconsistent flag for Backup creation request.
8484
If this value is set to true, backup is taken even if we are not able to acquire lock.
@@ -89,7 +89,7 @@ This field is **immutable**: can't be changed after backup creation
8989

9090
[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L66)
9191

92-
### .spec.options.timeout: float32
92+
### .spec.options.timeout: number
9393

9494
Timeout for Backup creation request in seconds.
9595

@@ -139,17 +139,17 @@ This field is **immutable**: can't be changed after backup creation
139139

140140
## Status
141141

142-
### .status.available: bool
142+
### .status.available: boolean
143143

144144
Available Determines if we can restore from ArangoBackup
145145

146146
[Code Reference](/pkg/apis/backup/v1/backup_status.go#L36)
147147

148-
### .status.backoff.iterations: int
148+
### .status.backoff.iterations: integer
149149

150150
[Code Reference](/pkg/apis/backup/v1/backup_status_backoff.go#L30)
151151

152-
### .status.backup.downloaded: bool
152+
### .status.backup.downloaded: boolean
153153

154154
Downloaded Determines if ArangoBackup has been downloaded.
155155

@@ -159,31 +159,31 @@ Downloaded Determines if ArangoBackup has been downloaded.
159159

160160
[Code Reference](/pkg/apis/backup/v1/backup_status.go#L56)
161161

162-
### .status.backup.imported: bool
162+
### .status.backup.imported: boolean
163163

164164
[Code Reference](/pkg/apis/backup/v1/backup_status.go#L67)
165165

166-
### .status.backup.keys: []string
166+
### .status.backup.keys: array
167167

168168
[Code Reference](/pkg/apis/backup/v1/backup_status.go#L70)
169169

170-
### .status.backup.numberOfDBServers: uint
170+
### .status.backup.numberOfDBServers: integer
171171

172172
NumberOfDBServers Cluster size of the Backup in ArangoDB
173173

174174
[Code Reference](/pkg/apis/backup/v1/backup_status.go#L62)
175175

176-
### .status.backup.potentiallyInconsistent: bool
176+
### .status.backup.potentiallyInconsistent: boolean
177177

178178
[Code Reference](/pkg/apis/backup/v1/backup_status.go#L58)
179179

180-
### .status.backup.sizeInBytes: uint64
180+
### .status.backup.sizeInBytes: integer
181181

182182
SizeInBytes Size of the Backup in ArangoDB.
183183

184184
[Code Reference](/pkg/apis/backup/v1/backup_status.go#L60)
185185

186-
### .status.backup.uploaded: bool
186+
### .status.backup.uploaded: boolean
187187

188188
Uploaded Determines if ArangoBackup has been uploaded
189189

docs/api/ArangoBackupPolicy.V1.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22

33
## Spec
44

5-
### .spec.allowConcurrent: bool
5+
### .spec.allowConcurrent: boolean
66

77
AllowConcurrent if false, ArangoBackup will not be created when previous Backups are not finished
88

99
Default Value: true
1010

1111
[Code Reference](/pkg/apis/backup/v1/backup_policy_spec.go#L35)
1212

13-
### .spec.maxBackups: int
13+
### .spec.maxBackups: integer
1414

1515
MaxBackups defines how many backups should be kept in history (per deployment). Oldest healthy Backups will be deleted.
1616
If not specified or 0 then no limit is applied
@@ -35,37 +35,37 @@ Links:
3535

3636
[Code Reference](/pkg/apis/backup/v1/backup_policy_spec.go#L39)
3737

38-
### .spec.template.backoff.iterations: int
38+
### .spec.template.backoff.iterations: integer
3939

4040
Iterations defines number of iterations before reaching MaxDelay. Default to 5
4141

4242
[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L31)
4343

44-
### .spec.template.backoff.max_delay: int
44+
### .spec.template.backoff.max_delay: integer
4545

4646
MaxDelay defines maximum delay in seconds. Default to 600
4747

4848
[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L29)
4949

50-
### .spec.template.backoff.max_iterations: int
50+
### .spec.template.backoff.max_iterations: integer
5151

5252
MaxIterations defines maximum number of iterations after backoff will be disabled. Default to nil (no limit)
5353

5454
[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L33)
5555

56-
### .spec.template.backoff.min_delay: int
56+
### .spec.template.backoff.min_delay: integer
5757

5858
MinDelay defines minimum delay in seconds. Default to 30
5959

6060
[Code Reference](/pkg/apis/backup/v1/backup_spec_backoff.go#L27)
6161

62-
### .spec.template.lifetime: int64
62+
### .spec.template.lifetime: integer
6363

6464
Lifetime is the time after which the backup will be deleted. Format: "1.5h" or "2h45m".
6565

6666
[Code Reference](/pkg/apis/backup/v1/backup_policy_spec.go#L61)
6767

68-
### .spec.template.options.allowInconsistent: bool
68+
### .spec.template.options.allowInconsistent: boolean
6969

7070
AllowInconsistent flag for Backup creation request.
7171
If this value is set to true, backup is taken even if we are not able to acquire lock.
@@ -76,7 +76,7 @@ This field is **immutable**: can't be changed after backup creation
7676

7777
[Code Reference](/pkg/apis/backup/v1/backup_spec.go#L66)
7878

79-
### .spec.template.options.timeout: float32
79+
### .spec.template.options.timeout: number
8080

8181
Timeout for Backup creation request in seconds.
8282

0 commit comments

Comments
 (0)