Docs for AlignContent and JustifyContent variants are confusing and inconsistent.

[rparrett]

How can Bevy's documentation be improved?

Specifically, AlignContent::SpaceEvenly is quite confusing, but we should look over all variants and look for ways to make them less confusing and more consistent.

The language used in AlignContent is not consistent with the language used in JustifyContent, and the language used among variants in each is not consistent.

The corresponding fields of Style link off to the MDN docs which are worded very precisely, but are confusing in their own way. The enums or their variants don't have this link. We may want to at least link to MDN for the enums themselves (every variant seems excessive) as well.

For convenience:

bevy/crates/bevy_ui/src/ui_node.rs

Lines 565 to 594 in 61bad4e

	/// Defines how each line is aligned within the flexbox.
	///
	/// It only applies if [`FlexWrap::Wrap`] is present and if there are multiple lines of items.
	#[derive(Copy, Clone, PartialEq, Eq, Debug, Serialize, Deserialize, Reflect)]
	#[reflect(PartialEq, Serialize, Deserialize)]
	pub enum AlignContent {
	/// The items are packed in their default position as if no alignment was applied
	Default,
	/// Each line moves towards the start of the cross axis.
	Start,
	/// Each line moves towards the end of the cross axis.
	End,
	/// Each line moves towards the start of the cross axis, unless the flex direction is reversed; then the line moves towards the end of the cross axis.
	FlexStart,
	/// Each line moves towards the end of the cross axis, unless the flex direction is reversed; then the line moves towards the start of the cross axis.
	FlexEnd,
	/// Each line moves towards the center of the cross axis.
	Center,
	/// Each line will stretch to fill the remaining space.
	Stretch,
	/// Each line fills the space it needs, putting the remaining space, if any
	/// inbetween the lines.
	SpaceBetween,
	/// The gap between the first and last items is exactly THE SAME as the gap between items.
	/// The gaps are distributed evenly.
	SpaceEvenly,
	/// Each line fills the space it needs, putting the remaining space, if any
	/// around the lines.
	SpaceAround,
	}

bevy/crates/bevy_ui/src/ui_node.rs

Lines 606 to 628 in 61bad4e

	/// Defines how items are aligned according to the main axis
	#[derive(Copy, Clone, PartialEq, Eq, Debug, Serialize, Deserialize, Reflect)]
	#[reflect(PartialEq, Serialize, Deserialize)]
	pub enum JustifyContent {
	/// The items are packed in their default position as if no alignment was applied
	Default,
	/// Items are packed toward the start of the axis.
	Start,
	/// Items are packed toward the end of the axis.
	End,
	/// Pushed towards the start, unless the flex direction is reversed; then pushed towards the end.
	FlexStart,
	/// Pushed towards the end, unless the flex direction is reversed; then pushed towards the start.
	FlexEnd,
	/// Centered along the main axis.
	Center,
	/// Remaining space is distributed between the items.
	SpaceBetween,
	/// Remaining space is distributed around the items.
	SpaceAround,
	/// Like [`JustifyContent::SpaceAround`] but with even spacing between items.
	SpaceEvenly,
	}