Feature/semantic documentation (rjsf-team#1907)

* rjsf-team#1897 * fix: documentation links * Apply suggestions from code review Co-authored-by: Ashwin Ramaswami <aramaswamis@gmail.com> Co-authored-by: Jacques <jacques@trixta.com> Co-authored-by: Ashwin Ramaswami <aramaswamis@gmail.com>

Author: 3 people

docs/advanced-customization/internals.md

@@ -14,9 +14,9 @@ This component follows [JSON Schema](http://json-schema.org/documentation.html)
 
  The `anyOf` and `oneOf` keywords are supported; however, properties declared inside the `anyOf/oneOf` should not overlap with properties "outside" of the `anyOf/oneOf`.
 
- You can also use `oneOf` with [schema dependencies](dependencies.md#schema-dependencies) to dynamically add schema properties based on input data.
+ You can also use `oneOf` with [schema dependencies](../usage/dependencies.md) to dynamically add schema properties based on input data.
 
- The `allOf` keyword is supported; it uses [json-schema-merge-allof](https://github.com/mokkabonna/json-schema-merge-allof) to merge subschemas to render the final combined schema in the form. When these subschemas are incompatible, though (or if the library has an error merging it), the `allOf` keyword is dropped from the schema. 
+ The `allOf` keyword is supported; it uses [json-schema-merge-allof](https://github.com/mokkabonna/json-schema-merge-allof) to merge subschemas to render the final combined schema in the form. When these subschemas are incompatible, though (or if the library has an error merging it), the `allOf` keyword is dropped from the schema.
 
 * `"additionalProperties":false` produces incorrect schemas when used with [schema dependencies](#schema-dependencies). This library does not remove extra properties, which causes validation to fail. It is recommended to avoid setting `"additionalProperties":false` when you use schema dependencies. See [#848](https://github.com/rjsf-team/react-jsonschema-form/issues/848) [#902](https://github.com/rjsf-team/rjsf-team/issues/902) [#992](https://github.com/rjsf-team/rjsf-team/issues/992)
 
@@ -32,9 +32,9 @@ Check out the defaults example on the [live playground](https://rjsf-team.github
 
 There are three different cases which need to be considered for the merging. Objects, arrays and scalar values. This library always deeply merges any defaults with the existing form data for objects.
 
-This are the rules which are used when injecting the defaults: 
+This are the rules which are used when injecting the defaults:
 
-- When the is a scalar in the form data, nothing is changed. 
+- When there is a scalar in the form data, nothing is changed.
 - When the value is `undefined` in the form data, the default is created in the form data.
 - When the value is an object in the form data, the defaults are deeply merged into the form data, using the rules defined here for the deep merge.
 - Then the value is an array in the form data, defaults are only injected in existing array items. No new array items will be created, even if the schema has minItems or additional items defined.

docs/api-reference/form-props.md

@@ -6,7 +6,7 @@ The value of this prop will be passed to the `accept-charset` [HTML attribute on
 
 ## action
 
-The value of this prop will be passed to the `action` [HTML attribute on the form](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form#attr-action). 
+The value of this prop will be passed to the `action` [HTML attribute on the form](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form#attr-action).
 
 Note that this just renders the `action` attribute in the HTML markup. There is no real network request being sent to this `action` on submit. Instead, react-jsonschema-form catches the submit event with `event.preventDefault()` and then calls the [`onSubmit`](#onSubmit) function, where you could send a request programmatically with `fetch` or similar.
 
@@ -16,7 +16,7 @@ This prop allows you to validate the form data against another JSON Schema meta
 
 ## ArrayFieldTemplate
 
-React component used to customize how alls arrays are rendered on the form. See [Custom Templates](custom-templates.md) for more information.
+React component used to customize how alls arrays are rendered on the form. See [Custom Templates](../advanced-customization/custom-templates.md) for more information.
 
 ## autoComplete
 
@@ -57,28 +57,28 @@ This prop allows you to define custom formats for validation. See [Validation](.
 
 ## disabled
 
-It's possible to disable the whole form by setting the `disabled` prop. The `disabled` prop is then forwarded down to each field of the form. 
+It's possible to disable the whole form by setting the `disabled` prop. The `disabled` prop is then forwarded down to each field of the form.
 
 ```jsx
 const schema = {
  type: "string"
 };
 
 render((
- <Form schema={schema} 
+ <Form schema={schema}
  disabled />
 ), document.getElementById("app"));
 ```
 
-If you just want to disable some of the fields, see the `ui:disabled` parameter in `uiSchema`. 
+If you just want to disable some of the fields, see the `ui:disabled` parameter in `uiSchema`.
 
 ## enctype
 
 The value of this prop will be passed to the `enctype` [HTML attribute on the form](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form#attr-enctype).
 
 ## extraErrors
 
-This prop allows passing in custom errors that are augmented with the existing JSON Schema errors on the form; it can be used to implement asynchronous validation. See [Validation](../usage/validation.md) for more information. 
+This prop allows passing in custom errors that are augmented with the existing JSON Schema errors on the form; it can be used to implement asynchronous validation. See [Validation](../usage/validation.md) for more information.
 
 ## ErrorList
 
@@ -147,7 +147,7 @@ If set to true, turns off all validation. Set to `false` by default.
 
 ## ObjectFieldTemplate
 
-React component used to customize how all objects are rendered in the form. See [Custom Templates](custom-templates.md) for more information.
+React component used to customize how all objects are rendered in the form. See [Custom Templates](../advanced-customization/custom-templates.md) for more information.
 
 ## omitExtraData
 
@@ -201,7 +201,7 @@ render((
 
 ## schema
 
-Form schema. We support JSON schema draft-07 by default. See [Schema Reference](api-reference-schema.md) for more information.
+Form schema. We support JSON schema draft-07 by default. See [Schema Reference]((https://json-schema.org/draft-07/json-schema-release-notes.html) for more information.
 
 ## showErrorList
 
@@ -238,7 +238,7 @@ A function can be passed to this prop in order to make modifications to the defa
 
 ## uiSchema
 
-Form uiSchema. See [uiSchema Reference](api-reference-uischema.md) for more information.
+Form uiSchema. See [uiSchema Reference](uiSchema.md) for more information.
 
 ## validate
 

docs/themes/semantic-ui/uiSchema.md renamed to docs/api-reference/themes/semantic-ui/uiSchema.md

@@ -1,5 +1,4 @@
 # uiSchema
-
 JSON Schema is limited for describing how a given data type should be rendered as a form input component. That's why this library introduces the concept of uiSchema.
 
 A UI schema is basically an object literal providing information on **how** the form should be rendered, while the JSON schema tells **what**.
@@ -218,4 +217,6 @@ const uiSchema = {
  "ui:widget": "password",
  "ui:title": "Your password"
 };
-```
+```
+## Theme Options
+[Semantic UI](themes/semantic-ui/uiSchema.md)

docs/api-reference/uiSchema.md

@@ -38,7 +38,7 @@ render((
 ), document.getElementById("app"));
 ```
 
-For more information and examples of JSON Schema properties that this library supports, see [Using JSON Schema](usage/schema.md).
+For more information and examples of JSON Schema properties that this library supports, see [Using JSON Schema](/docs/usage/single.md).
 
 ## Form uiSchema
 
@@ -62,7 +62,7 @@ render((
 ```
 
 To customize object fields in the uiSchema, the structure of the
-uiSchema should be `{key: value}`, where `key` is the property key and `value` is an 
+uiSchema should be `{key: value}`, where `key` is the property key and `value` is an
 object with the uiSchema configuration for that particular property. For example:
 
 ```jsx
@@ -127,7 +127,7 @@ render((
 
 ### Form event handlers
 
-You can use event handlers such as `onChange`, `onError`, `onSubmit`, `onFocus`, and `onBlur` on the `<Form />` component; see the [Form Props Reference](api-reference-props.md) for more details.
+You can use event handlers such as `onChange`, `onError`, `onSubmit`, `onFocus`, and `onBlur` on the `<Form />` component; see the [Form Props Reference](/docs/api-reference/form-props.md) for more details.
 
 ### Controlled component
 
@@ -147,4 +147,4 @@ const App = () => {
 render((
  <App />
 ), document.getElementById("app"));
-```
+```

docs/quickstart.md

@@ -8,8 +8,8 @@ meaning that you must load the Bootstrap stylesheet on the page to view the form
  Theme Name | Status | Package Name / Link
  ---------- | ------- | -----------
  Bootstrap 3 (default) | Published | `@rjsf/core`
- material-ui | Published | `@rjsf/material-ui` 
- fluent-ui | Published | `@rjsf/fluent-ui` 
+ material-ui | Published | `@rjsf/material-ui`
+ fluent-ui | Published | `@rjsf/fluent-ui`
  antd | Published | `@rjsf/antd`
  Semantic UI | Published | `@rjsf/semantic-ui`
 
@@ -23,7 +23,7 @@ first install both `@rjsf/core` and `@rjsf/material-ui`. Then you can import the
 import Form from "@rjsf/material-ui";
 ```
 
-If you would like to contribute a theme with a new UI framework, please develop the theme using the `withTheme` component described in [Theme Customization](theme-customization.md) and make a PR!
+If you would like to contribute a theme with a new UI framework, please develop the theme using the `withTheme` component described in [Theme Customization](../advanced-customization/custom-themes.md) and make a PR!
 
 You can also use the uiSchema to add custom CSS class names to your form.
 

docs/usage/themes.md

@@ -25,7 +25,10 @@ nav:
  - Other Internals: advanced-customization/internals.md
  - Contributing: contributing.md
  - API Reference:
- - uiSchema: api-reference/uiSchema.md
+ - uiSchema:
+ - General Reference: api-reference/uiSchema.md
+ - Theme-Specific Reference:
+ - semantic-ui: api-reference/themes/semantic-ui/uiSchema.md
  - "<Form /> props": api-reference/form-props.md
 
 markdown_extensions: