diff --git a/docs/Building_Diagrams/Extensions.md b/docs/dev/extensions.md similarity index 87% rename from docs/Building_Diagrams/Extensions.md rename to docs/dev/extensions.md index b102772b..c7cdc734 100644 --- a/docs/Building_Diagrams/Extensions.md +++ b/docs/dev/extensions.md @@ -4,12 +4,11 @@ Extensions in SpiffArena provide a mechanism to augment the software with custom By leveraging extensions, users can implement functions or features not present in the standard offering. This powerful feature ensures adaptability to various business needs, from custom reports to specific user tools. -Here are some of the key aspects of using Extensions: +At a high level: -- Extensions are implemented within the process model repository. -- Once an extension is created, it can be made accessible via various UI elements which can be specified in its `extension_uischema.json` file. -- Access to an extension can be set up via permissions. +- Extensions are implemented as process models within the process model repository. - Configuration for an extension can be found and modified in its `extension_uischema.json` file. +- Access to an extension can be set up via permissions. ![Extensions](images/Extensions_dashboard.png) @@ -53,12 +52,12 @@ If your organization has specific needs not catered to by the standard SpiffAren Here are some of the use cases already implemented by our users: -- Implementing a time tracking system. -- Creating custom reports tailored to your business metrics. -- Incorporating arbitrary content into custom pages using markdown. -- Creating and accessing tailor-made APIs. -- Rendering the output of these APIs using jinja templates and markdown. +- Implementing a time tracking system +- Creating custom reports tailored to your business metrics +- Incorporating arbitrary content into custom pages using markdown (as in the above example) +- Creating and accessing tailor-made APIs +- Rendering the output of these APIs using jinja templates and markdown Extensions in SpiffArena offer a robust mechanism to tailor the software to unique business requirements. -When considering an extension, also consider whether the code would be more properly included in the core source code. +When considering an extension, also consider whether the code would be more properly included in the core source code or as a connector inside your [connector proxy](/dev/connector_proxy.md). In cases where an extension is appropriate, by following the instructions in this guide, organizations can expand the system's functionality to meet their unique needs. diff --git a/docs/Building_Diagrams/images/Extension1.png b/docs/dev/images/Extension1.png similarity index 100% rename from docs/Building_Diagrams/images/Extension1.png rename to docs/dev/images/Extension1.png diff --git a/docs/Building_Diagrams/images/Extension_UI_schema.png b/docs/dev/images/Extension_UI_schema.png similarity index 100% rename from docs/Building_Diagrams/images/Extension_UI_schema.png rename to docs/dev/images/Extension_UI_schema.png diff --git a/docs/Building_Diagrams/images/Extensions_dashboard.png b/docs/dev/images/Extensions_dashboard.png similarity index 100% rename from docs/Building_Diagrams/images/Extensions_dashboard.png rename to docs/dev/images/Extensions_dashboard.png diff --git a/docs/dev/process.md b/docs/dev/process.md index d63c695c..6963a7e7 100644 --- a/docs/dev/process.md +++ b/docs/dev/process.md @@ -38,9 +38,11 @@ Two independent security reviews have been performed on the codebase and mitigat ## Contributing -It would be great to have you contributing to the project. +This is the last page in the Technical Documentation section, where we keep content mainly intended for developers. +And that seems like as good a place as to mention that it would be great to have you contributing to the project! There is a [Contributing doc](https://github.com/sartography/spiff-arena/blob/main/CONTRIBUTING.rst) that you can follow. You can find other like-minded people in our [Discord](https://discord.gg/F6Kb7HNK7B). +Thank you! ```mermaid graph LR diff --git a/docs/index.md b/docs/index.md index 184ede1b..f96d06ba 100644 --- a/docs/index.md +++ b/docs/index.md @@ -15,6 +15,7 @@ dev/backend.md dev/frontend.md dev/connector_proxy.md dev/how_to_build_a_connector.md +dev/extensions.md dev/process.md ``` @@ -38,7 +39,6 @@ Building_Diagrams/sub-processes_and_call_activities.md Building_Diagrams/data.md Building_Diagrams/multiinstance.md Building_Diagrams/dmn.md -Building_Diagrams/Extensions.md Building_Diagrams/pools_and_lanes.md Building_Diagrams/Builtin_examples.md ```