Added more information to the README.md

Author: MelvMay-Unity

LowLevel/Packages/com.unity.2d.physics.lowlevelextras/README.md

@@ -2,3 +2,28 @@
 Physics2D LowLevel Extras is a package that contains extra scripts for use with the LowLevel 2D Physics features in Unity.
 
 This package is unsupported and is provided as example only to support the low-level project examples.
+
+---
+
+This package contains simple Unity components that encapsule low-level physics objects making it easy to get up and running quickly and easily.
+
+These components are all prefixed with "Scene" with the following being provided:
+- **SceneWorld** - Creates a [PhysicsWorld](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsWorld.html)
+- **SceneBody** - Creates a [PhysicsBody](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsBody.html)
+- Shapes:
+  - **SceneShape** - Creates a single [PhysicsShape](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsShape.html) with either [CircleGeometry](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.CircleGeometry.html), [CapsuleGeometry](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.CapsuleGeometry.html), [PolygonGeometry](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PolygonGeometry.html), [SegmentGeometry](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.SegmentGeometry.html) or [ChainSegmentGeometry](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.ChainSegmentGeometry.html).
+  - **SceneOutlineShape** - Creates multiple [PhysicsShape](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsShape.html) with [PolygonGeometry](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PolygonGeometry.html) in the form of an arbitrary concave/convex outline.
+  - **SceneSpriteShape** - Creates multiple [PhysicsShape](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsShape.html) with [PolygonGeometry](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PolygonGeometry.html) from the physics data contained in a [Sprite]https://docs.unity3d.com/6000.3/Documentation/ScriptReference/Sprite.html.
+  - **SceneChain** - Creates a single continuous set of [PhysicsShape](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsShape.html) with [ChainSegmentGeometry](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.ChainSegmentGeometry.html) with one-way feature.
+- Joints:
+  - **SceneDistanceJoint** - Creates a [PhysicsDistanceJoint](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsDistanceJoint.html).
+  - **SceneFixedJoint** - Creates a [PhysicsFixedJoint](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsDFixedJoint.html).
+  - **SceneHingeJoint** - Creates a [PhysicsHingeJoint](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsHingeJoint.html).
+  - **SceneIgnoreJoint** - Creates a [PhysicsIgnoreJoint](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsIgnoreJoint.html).
+  - **SceneRelativeJoint** - Creates a [PhysicsRelativeJoint](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsRelativeJoint.html).
+  - **SceneSliderJoint** - Creates a [PhysicsSliderJoint](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsSliderJoint.html).
+  - **SceneWheelJoint** - Creates a [PhysicsWheelJoint](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/LowLevelPhysics2D.PhysicsWheelJoint.html).
+  
+When a *SceneShape* or *SceneChain* is added to the scene, in-scene editors are available to edit the shape geometry directly in the scene.
+
+---

LowLevel/README.md

@@ -1,17 +1,32 @@
 # Physics 2D LowLevel Examples
+
 This repository contains test projects, examples and a test package for use with the LowLevel 2D Physics features in Unity.
 
 To use the low-level features, you will require Unity 6000.0.3a5 or beyond.
 
-
-# Physics 2D LowLevel Sandbox
-
-This repository contains examples that can be built to a player.
-To run, load the main "Sandbox" scene and press "Play". Alternately, built to a player and run.
-
+---
 Acknowledgement and thanks is made to Erin Catto, the creator of Box2D v3, from which significant portions of this "Sandbox" project is based upon.
 
 Go try it here!
 https://github.com/erincatto/box2d
+---
+
+### Physics 2D LowLevel Sandbox
+
+This repository contains examples that can be built to a player. To run, load the main "Sandbox" scene and press "Play". Alternately, build to a player and run.
+
+Each sample can be found in "Assets/Scenes/<Category>/<SampleName>" and all share the same configuration.
+
+In each sample there is at least a single ".cs" file containing all the sample code. There's also a ".unity" scene and finally a ".uxml" for the sample UI.
+
+The structure of the ".cs" script file is consistent for all samples and typically contains the following methods:
+
+- OnEnable - Grabs the Sandbox Manager and Camera Manipulator and initializes any sample fields. Also, other global physics or sandbox state may be overriden here. Here we always call "SetupOptions" and "SetupScene" (see below).
+- OnDisable - Typically destroys any temporary storage and restores any global physics or Sandbox state.
+- SetupOptions - This is always called from "OnEnable" and always configures the sample UI to dynamically control the sample (sample option in the lower-level UI).
+- SetupScene - This is always called from "OnEnable" but is also called from the sample UI when pressing the "ResetScene" button on all samples. Here is where all the sample physics objects are created.
+- Update - Some samples use this to perform per-frame updates such as world drawing.
+- Misc - Some samples have miscellaneous methods (sometimes used in "SetupScene") to spawn or control the physics objects. Some are hooked into the pre/post simulate to perform an action when the simulation is about to or has run.  
 
+The "Scripts" folder are typically utility scripts used by various scenes such as spawning physics objects i.e. ragdolls, softbodies etc.