Skip to content

Commit 7db168a

Browse files
update Open Source Docs from Roblox internal teams
1 parent c9bf674 commit 7db168a

File tree

6 files changed

+115
-138
lines changed

6 files changed

+115
-138
lines changed

content/en-us/cloud/reference/risk-levels.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ The "try it out" feature uses four risk levels, which control the warnings and r
4141
<td>&#9989;</td>
4242
<td>Yes (per endpoint, per session)</td>
4343
<td>Yes</td>
44-
<td>No</td>
44+
<td>Yes (after accepting second warning dialog)</td>
4545
</tr>
4646
<tr>
4747
<td>Critical</td>
@@ -60,6 +60,6 @@ The "try it out" feature uses four risk levels, which control the warnings and r
6060
- They display a confirmation dialog before you send a request. This dialog appears once per endpoint per browser session.
6161
- They show a warning banner to remind you of the risk level.
6262

63-
- **High risk** endpoints can modify or delete private information in ways that may be difficult or impossible to reverse. This category includes most DELETE operations and other potentially destructive actions. In addition to the confirmation dialog and warning banner from medium risk endpoints, cookie authentication is not supported for these endpoints.
63+
- **High risk** endpoints can modify or delete private information in ways that may be difficult or impossible to reverse. This category includes most DELETE operations and other potentially destructive actions. In addition to the confirmation dialog and warning banner from medium risk endpoints, a second confirmation dialog is required to send the first request (enforced only per session, not per endpoint).
6464

6565
- **Critical risk** endpoints access or modify highly sensitive data that could compromise account security or privacy. "Try it out" is disabled for these endpoints.

content/en-us/reference/engine/classes/GuiBase3d.yaml

Lines changed: 11 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,8 @@
55
name: GuiBase3d
66
type: class
77
memory_category: Instances
8-
summary: |
9-
An abstract class for 3D GUI elements that are rendered in the world.
10-
description: |
11-
An abstract class for 3D GUI elements that are rendered in the world.
8+
summary: An abstract class for 3D GUI elements that are rendered in the world.
9+
description: An abstract class for 3D GUI elements that are rendered in the world.
1210
code_samples: []
1311
inherits:
1412
- GuiBase
@@ -17,17 +15,15 @@ tags:
1715
deprecation_message: ''
1816
properties:
1917
- name: GuiBase3d.Color
20-
summary: |
21-
Sets the color of a GUI object.
22-
description: |
23-
Sets the color of a GUI object.
18+
summary: Sets the color of a GUI object.
19+
description: Sets the color of a GUI object.
2420
code_samples: []
2521
type: BrickColor
2622
tags:
2723
- Hidden
2824
- NotReplicated
2925
- Deprecated
30-
deprecation_message: |
26+
deprecation_message: |-
3127
This property has been deprecated in favor of `Class.GuiBase3d.Color3`,
3228
which allows for greater color customization and should be used in new
3329
work instead.
@@ -42,10 +38,8 @@ properties:
4238
capabilities:
4339
- UI
4440
- name: GuiBase3d.Color3
45-
summary: |
46-
Sets the color of a GUI object.
47-
description: |
48-
Sets the color of a GUI object.
41+
summary: Sets the color of this `Class.GuiBase3d` object.
42+
description: Sets the color of this `Class.GuiBase3d` object.
4943
code_samples: []
5044
type: Color3
5145
tags: []
@@ -61,12 +55,8 @@ properties:
6155
capabilities:
6256
- UI
6357
- name: GuiBase3d.Transparency
64-
summary: |
65-
Sets the transparency of a GUI object, where 1 is invisible and 0 is
66-
completely visible.
67-
description: |
68-
Sets the transparency of a GUI object, where 1 is invisible and 0 is
69-
completely visible.
58+
summary: Sets the transparency of this `Class.GuiBase3d` object.
59+
description: Sets the transparency of this `Class.GuiBase3d` object, where `1` is invisible and `0` is fully visible.
7060
code_samples: []
7161
type: float
7262
tags: []
@@ -82,10 +72,8 @@ properties:
8272
capabilities:
8373
- UI
8474
- name: GuiBase3d.Visible
85-
summary: |
86-
Determines whether the object and its descendants will be displayed.
87-
description: |
88-
Determines whether the object and its descendants will be displayed.
75+
summary: Determines whether this `Class.GuiBase3d` object and its descendants will be displayed.
76+
description: Determines whether this `Class.GuiBase3d` object and its descendants will be displayed.
8977
code_samples: []
9078
type: boolean
9179
tags: []

content/en-us/reference/engine/classes/HandleAdornment.yaml

Lines changed: 37 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,8 @@
55
name: HandleAdornment
66
type: class
77
memory_category: Instances
8-
summary: |
9-
HandleAdornment is an abstract class inherited by 3D handle adornments.
10-
description: |
11-
**Note:** For handles to be interactive, they must be parented to a player's
12-
`Class.PlayerGui` or the `Class.CoreGui`. **HandleAdornment** is an abstract
13-
class inherited by 3D handle adornments.
8+
summary: An abstract class inherited by 3D handle adornments.
9+
description: "`HandleAdornment` is an abstract class inherited by 3D handle adornments. If parented to a player's `Class.PlayerGui` or the `Class.CoreGui`, handles can listen to input events for purposes such as making dragger tools."
1410
code_samples: []
1511
inherits:
1612
- PVAdornment
@@ -19,9 +15,8 @@ tags:
1915
deprecation_message: ''
2016
properties:
2117
- name: HandleAdornment.AdornCullingMode
22-
summary: |
23-
Determines whether to automatically cull the adornment.
24-
description: ''
18+
summary: Determines whether to automatically cull the adornment.
19+
description: This property determines whether to automatically cull the adornment based on distance from the camera.
2520
code_samples: []
2621
type: AdornCullingMode
2722
tags: []
@@ -38,15 +33,10 @@ properties:
3833
- Basic
3934
- UI
4035
- name: HandleAdornment.AlwaysOnTop
41-
summary: |
42-
Forces this object to render on top of all 3D objects in the workspace.
43-
description: |
44-
Forces this object to render on top of all 3D objects in the workspace.
45-
Even if the adornment is behind a part based on its
46-
`Class.HandleAdornment.CFrame`, if **AlwaysOnTop** is true then the
47-
adornment will still draw on top. The one exception to this behavior is if
48-
the `Class.HandleAdornment.ZIndex` of the adornment is set to -1. If this
49-
is the case, the adornment will always draw behind 3D geometry.
36+
summary: Forces this adornment to render on top of all 3D objects in the workspace.
37+
description: |-
38+
If `true`, forces this adornment to render on top of all 3D objects in the
39+
workspace. As an exception, setting `Class.HandleAdornment.ZIndex|ZIndex` to `-1` will override an `Class.HandleAdornment.AlwaysOnTop|AlwaysOnTop` value of `true` and cause the adornment to appear either in front of or behind other adornments and objects based on their relative position in the 3D space.
5040
code_samples: []
5141
type: boolean
5242
tags: []
@@ -63,15 +53,13 @@ properties:
6353
- Basic
6454
- UI
6555
- name: HandleAdornment.CFrame
66-
summary: |
56+
summary: |-
6757
The position and rotation of the object relative to its
6858
`Class.PVAdornment.Adornee`.
69-
description: |
70-
The position and rotation relative to its `Class.PVAdornment.Adornee`.
71-
This CFrame is in the local space of the adornee, so forward (0,0,-1) will
72-
be forward relative to the adornee. The offset and rotation of this CFrame
73-
is applied after any translations due to
74-
`Class.HandleAdornment.SizeRelativeOffset`.
59+
description: |-
60+
`Datatype.CFrame` position and rotation relative to its
61+
`Class.PVAdornment.Adornee`, applied after any translations due to
62+
`Class.HandleAdornment.SizeRelativeOffset|SizeRelativeOffset`.
7563
code_samples: []
7664
type: CFrame
7765
tags: []
@@ -88,23 +76,16 @@ properties:
8876
- Basic
8977
- UI
9078
- name: HandleAdornment.SizeRelativeOffset
91-
summary: |
79+
summary: |-
9280
The positional offset of the adornment based on the adornee's
9381
`Class.BasePart.Size`.
94-
description: |
95-
The positional offset of the adornment based on the adornee's
96-
`Class.BasePart.Size`. By default, an adornment draws in the center of its
97-
adornee. By using this property, the position of the adornment can be
98-
shifted relative to the center of the adornee. The units of
99-
**SizeRelativeOffset** are a scale based on the size of the adornee
100-
itself. This scale is such that a value of 1 will move the adornment to
101-
the corresponding edge of the adornee. This property is intended to allow
102-
adornments to easily be moved to the edges of a parts.
82+
description: |-
83+
By default, an adornment draws in the center of its
84+
`Class.HandleAdornment.Adornee|Adornee`, but this property shifts the
85+
adornment's relative position based on the adornee's `Class.BasePart.Size`.
10386
104-
For example, if the **SizeRelativeOffset** is set to (0,1,0), the
105-
adornment will be drawn with its center at the exact top of the adornee.
106-
If set to (1,1,1), the adornment will be drawn in the upper corner of the
107-
adornee.
87+
Note that the units of `Class.HandleAdornment.SizeRelativeOffset|SizeRelativeOffset` are a **scale** based on the size of the adornee itself, such that a value of `1` will move the adornment to the corresponding edge of the adornee. For example, a value of
88+
`Datatype.Vector3.new(0, 1, 0)` will shift the adornment to the exact top of its adornee.
10889
code_samples: []
10990
type: Vector3
11091
tags: []
@@ -121,21 +102,13 @@ properties:
121102
- Basic
122103
- UI
123104
- name: HandleAdornment.ZIndex
124-
summary: |
125-
Determines the draw order of the `Class.HandleAdornment`.
126-
description: |
127-
The `ZIndex` property determines the draw order of the
128-
`Class.HandleAdornment`. This only refers to how the adornment will draw
129-
relative to other adornments or 3D objects in the workspace. This does not
130-
relate to the `Class.GuiObject.ZIndex` of GuiObjects.
105+
summary: Determines the draw order of this `Class.HandleAdornment` when `Class.HandleAdornment.AlwaysOnTop|AlwaysOnTop` is `true`.
106+
description: |-
107+
Only applies if `Class.HandleAdornment.AlwaysOnTop|AlwaysOnTop` is `true` and determines the draw order of this `Class.HandleAdornment` relative to other adornments. It does not relate to the `Class.GuiObject.ZIndex|ZIndex` property for `Class.GuiObject|GuiObjects`.
108+
109+
Valid values are from `-1` to `10` with higher values drawing on top (in front) of lesser values. This drawing order will be respected even if an adornment is in front of or behind another adornment in the 3D space.
131110
132-
The valid values for ZIndex are from -1 to 10. If two HandleAdornments are
133-
drawn over one another, the one with the higher ZIndex will be drawn. This
134-
order of drawing will be respected even if the adornment with higher
135-
ZIndex is behind the other adornment in terms of its position in 3D space.
136-
If set to -1, ZIndex will force the adornment to draw behind other
137-
adornments and objects in the Workspace, even if the
138-
`Class.HandleAdornment.AlwaysOnTop` property for the adornment is true.
111+
As an exception, setting `Class.HandleAdornment.ZIndex|ZIndex` to `-1` or `Class.HandleAdornment.AlwaysOnTop|AlwaysOnTop` to `false` will cause the adornment to appear either in front of or behind other adornments and objects based on their relative position in the 3D space.
139112
code_samples: []
140113
type: int
141114
tags: []
@@ -154,12 +127,11 @@ properties:
154127
methods: []
155128
events:
156129
- name: HandleAdornment.MouseButton1Down
157-
summary: |
158-
Fires when a user presses down on their left mouse button while hovering
159-
over the adornment.
160-
description: |
161-
Fires when a user presses down on their left mouse button while hovering
162-
over the adornment.
130+
summary: Fires when a player presses down on their left mouse button while hovering over the adornment.
131+
description: |-
132+
This event fires when a player presses down their left mouse button while
133+
hovering over the adornment. Only fires if the adornment is parented to a
134+
player's `Class.PlayerGui` or the `Class.CoreGui`.
163135
code_samples: []
164136
parameters: []
165137
tags: []
@@ -169,12 +141,8 @@ events:
169141
- Basic
170142
- UI
171143
- name: HandleAdornment.MouseButton1Up
172-
summary: |
173-
Fires when a user releases their left mouse button while hovering over the
174-
adornment.
175-
description: |
176-
Fires when a user releases their left mouse button while hovering over the
177-
adornment.
144+
summary: Fires when a player releases their left mouse button while hovering over the adornment.
145+
description: This event fires when a player releases their left mouse button while hovering over the adornment. Only fires if the adornment is parented to a player's `Class.PlayerGui` or the `Class.CoreGui`.
178146
code_samples: []
179147
parameters: []
180148
tags: []
@@ -184,10 +152,8 @@ events:
184152
- Basic
185153
- UI
186154
- name: HandleAdornment.MouseEnter
187-
summary: |
188-
Fires when a user moves their mouse over the adornment.
189-
description: |
190-
Fires when a user moves their mouse over the adornment.
155+
summary: Fires when a player moves their mouse over the adornment.
156+
description: This event fires when a player moves their mouse over the adornment. Only fires if the adornment is parented to a player's `Class.PlayerGui` or the `Class.CoreGui`.
191157
code_samples: []
192158
parameters: []
193159
tags: []
@@ -197,10 +163,8 @@ events:
197163
- Basic
198164
- UI
199165
- name: HandleAdornment.MouseLeave
200-
summary: |
201-
Fires when a user moves their mouse out of the adornment.
202-
description: |
203-
Fires when a user moves their mouse out of the adornment.
166+
summary: Fires when a player moves their mouse out of the adornment.
167+
description: This event fires when a player moves their mouse out of the adornment. Only fires if the adornment is parented to a player's `Class.PlayerGui` or the `Class.CoreGui`.
204168
code_samples: []
205169
parameters: []
206170
tags: []

content/en-us/reference/engine/classes/PVAdornment.yaml

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,8 @@
55
name: PVAdornment
66
type: class
77
memory_category: Instances
8-
summary: |
9-
The PVAdornment class is an abstract class of which the inheritors can be
10-
adorned to objects of the PVInstance class.
11-
description: |
12-
The PVAdornment class is an abstract class of which the inheritors can be
13-
adorned to objects of the PVInstance class.
8+
summary: An abstract class of which the inheritors can be adorned to objects of the `Class.PVInstance` class.
9+
description: The `Class.PVAdornment` class is an abstract class of which the inheritors can be adorned to objects of the `Class.PVInstance` class.
1410
code_samples: []
1511
inherits:
1612
- GuiBase3d
@@ -19,12 +15,10 @@ tags:
1915
deprecation_message: ''
2016
properties:
2117
- name: PVAdornment.Adornee
22-
summary: |
23-
The `Class.PVInstance` the PVAdornment is attached to.
24-
description: |
25-
The `Class.PVInstance` the PVAdornment is attached to. An adornment will
26-
stay positioned and rotated relative to its adornee, even if the adornee
27-
moves.
18+
summary: The `Class.PVInstance` which this `Class.PVAdornment` is attached to.
19+
description: |-
20+
The `Class.PVInstance` which this `Class.PVAdornment` is attached to. An
21+
adornment will stay positioned and rotated relative to its adornee, even if the adornee moves.
2822
code_samples: []
2923
type: PVInstance
3024
tags: []

0 commit comments

Comments
 (0)