From 5a873618b108f686a6461a8e89db2f6db0c3dbf4 Mon Sep 17 00:00:00 2001
From: Beck <164545837+validbeck@users.noreply.github.com>
Date: Mon, 7 Apr 2025 12:08:18 -0700
Subject: [PATCH 1/4] Documentation: Manage model stakeholder types (#686)
* Draft for stakeholder types
* Cleanup model stakeholder types
* Added stakeholder instructions to edit fields
* Editing
* Quick adjust
* Quick adjust x2
---
site/_quarto.yml | 1 +
site/guide/configuration/_manage-roles.qmd | 72 ++++++++++++++--
.../manage-model-stakeholder-types.qmd | 83 +++++++++++++++++++
site/guide/configuration/managing-users.qmd | 5 +-
.../edit-model-inventory-fields.qmd | 20 ++++-
.../manage-model-inventory-fields.qmd | 6 +-
6 files changed, 170 insertions(+), 17 deletions(-)
create mode 100644 site/guide/configuration/manage-model-stakeholder-types.qmd
diff --git a/site/_quarto.yml b/site/_quarto.yml
index bd23da11ce..c06596a41c 100644
--- a/site/_quarto.yml
+++ b/site/_quarto.yml
@@ -246,6 +246,7 @@ website:
- guide/configuration/manage-users.qmd
- guide/configuration/manage-groups.qmd
- guide/configuration/manage-roles.qmd
+ - guide/configuration/manage-model-stakeholder-types.qmd
- guide/configuration/manage-permissions.qmd
- file: guide/configuration/personalize-validmind.qmd
contents:
diff --git a/site/guide/configuration/_manage-roles.qmd b/site/guide/configuration/_manage-roles.qmd
index 25a838e5ce..52c81806be 100644
--- a/site/guide/configuration/_manage-roles.qmd
+++ b/site/guide/configuration/_manage-roles.qmd
@@ -1,17 +1,69 @@
+:::: {.content-visible unless-format="revealjs"}
1. Under User Permissions, select **{{< fa user-group >}} Roles**.
1. Click **{{< fa plus >}} Add New Role**.
-1. Enter the **[name]{.smallcaps}** and **[description]{.smallcaps}** for the role.
+1. Enter the unique **[name]{.smallcaps}** and **[description]{.smallcaps}** for the role.^[Role names and model stakeholder type names cannot be duplicated to reduce confusion.]
1. Once you click **{{< fa plus >}} Add Role**, you can proceed with managing the permissions and users associated with that role.
#### Manage role permissions
-On the **Permissions** tab, you can:
+1. Click on the role whose permissions you want to change.
- - View the current permissions assigned to that role.
- - Select permissions to be assigned to that role.
+1. Select the **Permissions** tab, where you can:
+
+ - View the current permissions assigned to that role.
+ - Select permissions to be assigned to that role.
+
+1. Select **Edit Permissions** to to add or remove permissions to or from that role.
+
+1. Toggle specific permissions for that role by checking or unchecking the boxes next to the permission.
+
+1. Click **Save Permissions** to apply your changes.
+
+#### Manage role users
+
+1. Click on the role whose users you want to manage.
+
+1. Select the **Users** tab, where you can:
+
+ - View a list of users assigned to that role.
+ - Add a role to users on that list.
+
+##### Add role to user
+
+ 1. Click **+** to open the Assign Roles menu for that user.
+
+ 1. Click **+** next to the role for each role to be assigned.
+
+ 1. Click **{{< fa puzzle-piece >}} Assign Roles to User** to save changes.
+
+##### Delete role from user
+
+1. Click **{{< fa x >}}** to delete a role from a user.
+
+1. Once you confirm, that role will be removed from the user.
+
+::::
+
+:::: {.content-hidden unless-format="revealjs"}
+1. Under User Permissions, select **{{< fa user-group >}} Roles**.
+
+1. Click **{{< fa plus >}} Add New Role**.
+
+1. Enter the unique **[name]{.smallcaps}** and **[description]{.smallcaps}** for the role.
+
+1. Once you click **{{< fa plus >}} Add Role**, you can proceed with managing the permissions and users associated with that role.
+
+#### Manage role permissions
+
+1. Click on the role whose permissions you want to change.
+
+1. Select the **Permissions** tab, where you can:
+
+ - View the current permissions assigned to that role.
+ - Select permissions to be assigned to that role.
1. Select **Edit Permissions** to to add or remove permissions to or from that role.
@@ -21,10 +73,12 @@ On the **Permissions** tab, you can:
#### Manage role users
-On the **Users** tab, you can:
+1. Click on the role whose users you want to manage.
- - View a list of users assigned to that role.
- - Add a role to users on that list.
+1. Select the **Users** tab, where you can:
+
+ - View a list of users assigned to that role.
+ - Add a role to users on that list.
##### Add role to user
@@ -38,4 +92,6 @@ On the **Users** tab, you can:
1. Click **{{< fa x >}}** to delete a role from a user.
-1. Once you confirm, that role will be removed from the user.
\ No newline at end of file
+1. Once you confirm, that role will be removed from the user.
+
+::::
\ No newline at end of file
diff --git a/site/guide/configuration/manage-model-stakeholder-types.qmd b/site/guide/configuration/manage-model-stakeholder-types.qmd
new file mode 100644
index 0000000000..e551c921fe
--- /dev/null
+++ b/site/guide/configuration/manage-model-stakeholder-types.qmd
@@ -0,0 +1,83 @@
+---
+title: "Manage model stakeholder types"
+date: last-modified
+---
+
+Model stakeholders determine specific responsibilities and access levels for model review and approval processes for each model in your model inventory, such as read or edit access to model inventory fields.
+
+::: {.callout title="What permissions do model stakeholders have?"}
+Each model stakeholder also belongs to user groups which determine which models they can see, and have user roles with attached role permissions which define the level of access they have to overarching {{< var validmind.platform >}} features.
+
+:::
+
+::: {.attn}
+
+## Prerequisites
+
+- [x] {{< var link.login >}}
+- [x] You are a [{{< fa hand >}} Customer Admin]{.bubble} or assigned another role with sufficient permissions to perform the tasks in this guide.[^1]
+
+:::
+
+
+## Add or edit model stakeholder types
+
+::: {.callout-important}
+Please note that the stock **Model Developer**, **Model Owner**, and **Model Validator** stakeholder types are required by default for all models, and as such cannot be cannot be modified.
+:::
+
+1. In the left sidebar, click **{{< fa gear >}} Settings**.
+
+2. Under User Permissions, select **{{< fa users >}} Model Stakeholder Types**.
+
+3. Click **{{< fa plus >}} Add New Stakeholder Type**.
+
+4. Enter the unique **[name]{.smallcaps}** and **[description]{.smallcaps}** for the stakeholder type.[^2]
+
+5. Once you click **{{< fa plus >}} Add Type**, you can proceed with managing the model inventory field[^3] permissions associated with that type.
+
+#### Manage stakeholder type permissions
+
+1. Click on the stakeholder type whose permissions you want to change.
+
+1. On the **Permissions** tab, you can:
+
+ - View the current model inventory field permissions assigned to that type.
+ - Select model inventory field permissions to be assigned to that type.
+
+1. Select **Edit Permissions** to to add or remove model inventory field permissions to or from that type.
+
+1. Toggle specific permissions for that stakeholder type by checking or unchecking the boxes next to the permission.
+
+1. Click **Save Permissions** to apply your changes.
+
+## Manage stakeholder types on models
+
+::: {.callout-important title="Changes will only apply to individual models."}
+Adding a model stakeholder type on one model in your inventory will not affect the stakeholder types on the other models within your inventory.
+:::
+
+1. In the left sidebar, click **{{< fa cubes >}} Inventory**.
+
+2. Select a model or find your model by applying a filter or searching for it.[^4]
+
+3. Click **{{< fa user-plus >}} Manage Model Stakeholders**.
+
+4. Toggle the stakeholder types you would like to display for that model.
+
+5. Add at least one user to each of your desired custom stakeholder types to save the display settings for that model:
+
+ a. Click on your model stakeholder type.
+ b. Select your users from the drop-down menu.
+ c. Click **Save** to apply your changes.
+
+
+
+
+[^1]: [Manage permissions](/guide/configuration/manage-permissions.qmd)
+
+[^2]: Role names and stakeholder type names cannot be duplicated to reduce confusion.
+
+[^3]: [Manage model inventory fields](/guide/model-inventory/manage-model-inventory-fields.qmd)
+
+[^4]: [Working with the model inventory](/guide/model-inventory/working-with-model-inventory.qmd#search-filter-and-sort-models)
\ No newline at end of file
diff --git a/site/guide/configuration/managing-users.qmd b/site/guide/configuration/managing-users.qmd
index d7b300deec..222af1d9fd 100644
--- a/site/guide/configuration/managing-users.qmd
+++ b/site/guide/configuration/managing-users.qmd
@@ -4,7 +4,7 @@ date: last-modified
listing:
- id: whats-next-listing
type: grid
- grid-columns: 2
+ grid-columns: 3
max-description-length: 250
sort: false
fields: [title, description]
@@ -13,12 +13,13 @@ listing:
- ./manage-users.qmd
- ./manage-groups.qmd
- ./manage-roles.qmd
+ - ./manage-model-stakeholder-types.qmd
- ./manage-permissions.qmd
aliases:
- /guide/onboarding-users.html
---
-Control and organize who has access to the {{< var validmind.platform >}} and what features they're able to use. Invite users, create user groups and roles, and assign roles to users and permissions to your roles.
+Control and organize who has access to the {{< var validmind.platform >}} and what features they're able to use. Invite users, create user groups and roles, and assign roles to users and permissions to your roles.
## Key concepts
diff --git a/site/guide/model-inventory/edit-model-inventory-fields.qmd b/site/guide/model-inventory/edit-model-inventory-fields.qmd
index 1bfe9fa42e..0868c06711 100644
--- a/site/guide/model-inventory/edit-model-inventory-fields.qmd
+++ b/site/guide/model-inventory/edit-model-inventory-fields.qmd
@@ -13,7 +13,7 @@ Edit individual detail fields on a model to ensure that model details are accura
- [x] {{< var link.login >}}
- [x] The model is already registered in the model inventory.[^1]
-- [x] You are the model owner for the model you would like edit the details of, a [{{< fa hand >}} Customer Admin]{.bubble}, or assigned another role with sufficient permissions to perform the tasks in this guide.[^2]
+- [x] You are the model owner for the model you would like edit the details of, a [{{< fa hand >}} Customer Admin]{.bubble}, or assigned another role or stakeholder type with sufficient permissions to perform the tasks in this guide.[^2]
:::
@@ -23,15 +23,25 @@ Edit individual detail fields on a model to ensure that model details are accura
2. Select a model or find your model by applying a filter or searching for it.[^3]
-3. Hover over a field until the **{{< fa pencil >}}** appears, then click to make your changes:
+3. Hover over a field until the **{{< fa pencil >}}** appears, then click to make your changes:
- Click **Save** to apply your changes.
- Click **Cancel** to discard your changes.
+### Manage model stakeholders
+
+1. On the model's detail page, click on the model stakeholder type[^4] you'd like to add users to.
+
+2. Select your desired users from the drop-down menu.
+
+ To remove a user from a stakeholder type, click on the **{{< fa x >}}** to the right of their name.
+
+3. Click **Save** to apply your changes.
+
### Manage supporting documentation
::: {.callout title="Uploaded files must be less than 50 MB each in size."}
-To work with attachments on models, first add an attachment inventory field.[^4]
+To work with attachments on models, first add an attachment inventory field.[^5]
:::
#### Add attachments to a model
@@ -60,4 +70,6 @@ To work with attachments on models, first add an attachment inventory field.[^4]
[^3]: [Working with the model inventory](/guide/model-inventory/working-with-model-inventory.qmd#search-filter-and-sort-models)
-[^4]: [Manage model inventory fields](manage-model-inventory-fields.qmd#inventory-field-types)
+[^4]: [Manage model stakeholder types](/guide/configuration/manage-model-stakeholder-types.qmd)
+
+[^5]: [Manage model inventory fields](manage-model-inventory-fields.qmd#inventory-field-types)
diff --git a/site/guide/model-inventory/manage-model-inventory-fields.qmd b/site/guide/model-inventory/manage-model-inventory-fields.qmd
index cef23efb46..2a705197a8 100644
--- a/site/guide/model-inventory/manage-model-inventory-fields.qmd
+++ b/site/guide/model-inventory/manage-model-inventory-fields.qmd
@@ -29,7 +29,7 @@ Create and edit the fields that appear on all models in your model inventory. Ch
3. Fields require a [type]{.smallcaps},[^2] a [name]{.smallcaps}, and a [description]{.smallcaps}.
- You can also choose to indicate that a field is **[required on registration]{.smallcaps}**.
- - You can also assign **[write permissions]{.smallcaps}** to allow granular access to editing this field gated by roles.[^3]
+ - You can also assign **[write permissions]{.smallcaps}** to allow granular access to editing this field gated by model stakeholder types.[^3]
4. When you are satisfied with the setup of your field, click **Save**.
@@ -144,14 +144,14 @@ For example, say you have numeric model inventory fields of `materiality` and `c
[^2]: [Inventory field types](#inventory-field-types)
-[^3]:
+[^3]:
::: {.callout title="Leave this field blank to leave permissions as default."}
- By default, model owners and validators have write access.
- Model developers have read-only access.
::: {.tc}
- [Manage permissions](/guide/configuration/manage-permissions.qmd){.button .button-green}
+ [Manage model stakeholder types](/guide/configuration/manage-model-stakeholder-types.qmd)
:::
From fab3481a53f66a779cc60b84e2fdaa1a76e00f33 Mon Sep 17 00:00:00 2001
From: Beck <164545837+validbeck@users.noreply.github.com>
Date: Thu, 10 Apr 2025 13:05:04 -0700
Subject: [PATCH 2/4] Added new introductory validation notebooks (#689)
* Pulled in latest from validmind-library @ HEAD
* Modified developer portal to have python api css
* Testing get-source on new metadata file
* Draft for moved developer sidebar
* Edited listing tiles
* Adjusted wording for developer portal
* Reverting old developer notebook to main for training
* Tweak
* Editing terminology
* Latest from library & revering mini drop-down
* Reverting old developer notebook to main for training again
---
site/_quarto.yml | 63 +-
site/_variables.yml | 2 +-
site/developer/_metadata.yml | 8 +-
site/developer/_sidebar.yaml | 55 +
site/developer/validmind-library.qmd | 81 +-
site/notebooks.zip | Bin 10258062 -> 12308977 bytes
site/notebooks/_metadata.yml | 8 +-
.../quickstart_option_pricing_models.ipynb | 2 +-
...start_option_pricing_models_quantlib.ipynb | 2 +-
.../application_scorecard_demo.ipynb | 2 +-
.../application_scorecard_executive.ipynb | 2 +-
.../application_scorecard_full_suite.ipynb | 2 +-
.../application_scorecard_with_bias.ipynb | 2 +-
.../application_scorecard_with_ml.ipynb | 2 +-
.../custom_tests/implement_custom_tests.ipynb | 2 +-
.../validate_application_scorecard.ipynb | 1831 ++++++
.../model_validation/xgb_model_champion.pkl | Bin 0 -> 117919 bytes
.../nlp_and_llm/prompt_validation_demo.ipynb | 2 +-
.../nlp_and_llm/rag_benchmark_demo.ipynb | 1635 ++++++
.../nlp_and_llm/rag_documentation_demo.ipynb | 2 +-
...ication_scorecard_ongoing_monitoring.ipynb | 2 +-
...rt_customer_churn_ongoing_monitoring.ipynb | 2 +-
.../quickstart_time_series_full_suite.ipynb | 2 +-
.../quickstart_time_series_high_code.ipynb | 2 +-
.../add_context_to_llm_descriptions.ipynb | 14 +-
.../how_to/configure_dataset_features.ipynb | 2 +-
...t_multiple_results_for_the_same_test.ipynb | 2 +-
.../how_to/explore_test_suites.ipynb | 2 +-
site/notebooks/how_to/explore_tests.ipynb | 5147 ++++++++++-------
.../how_to/load_datasets_predictions.ipynb | 2 +-
.../how_to/log_metrics_over_time.ipynb | 2 +-
.../how_to/run_documentation_sections.ipynb | 2 +-
.../run_documentation_tests_with_config.ipynb | 2 +-
.../run_tests/1_run_dataset_based_tests.ipynb | 2 +-
.../run_tests/2_run_comparison_tests.ipynb | 2 +-
...tests_that_require_multiple_datasets.ipynb | 2 +-
site/notebooks/how_to/run_unit_metrics.ipynb | 2 +-
.../how_to/use_dataset_model_objects.ipynb | 2 +-
...quickstart_customer_churn_full_suite.ipynb | 6 +-
.../notebooks/templates/about-validmind.ipynb | 2 +-
...lidmind.ipynb => 1-set_up_validmind.ipynb} | 77 +-
...pynb => 2-start_development_process.ipynb} | 144 +-
...s.ipynb => 3-integrate_custom_tests.ipynb} | 89 +-
...=> 4-finalize_testing_documentation.ipynb} | 70 +-
.../model_development/my_tests_directory.png | Bin 44368 -> 0 bytes
.../1-set_up_validmind_for_validation.ipynb | 451 ++
.../2-start_validation_process.ipynb | 873 +++
.../3-developing_challenger_model.ipynb | 871 +++
.../4-finalize_validation_reporting.ipynb | 1207 ++++
.../class-imbalance-results-detail.png | Bin 0 -> 340258 bytes
.../model_validation/compliance-summary.png | Bin 0 -> 61626 bytes
.../inserted-class-imbalance-results.png | Bin 0 -> 89421 bytes
.../model_validation/inserted-finding.png | Bin 0 -> 94575 bytes
.../inserted-minimum-f1-scores.png | Bin 0 -> 110789 bytes
.../model_validation/link-finding.png | Bin 0 -> 287154 bytes
.../link-validator-evidence.png | Bin 0 -> 364135 bytes
.../link-validator-evidence_OLD.png | Bin 0 -> 398858 bytes
.../model_validation/lr_model_champion.pkl | Bin 0 -> 1020 bytes
.../model_validation/select-finding.png | Bin 0 -> 123751 bytes
.../selecting-class-imbalance-results.png | Bin 0 -> 106533 bytes
.../selecting-minimum-f1-scores.png | Bin 0 -> 327835 bytes
site/tests/_metadata.yml | 8 +-
site/validmind/_sidebar.yml | 6 +-
site/validmind/validmind.qmd | 45 +-
site/validmind/validmind/errors.qmd | 21 +
site/validmind/validmind/tests.qmd | 39 +-
.../tests/data_validation/ClassImbalance.qmd | 2 +-
.../data_validation/DatasetDescription.qmd | 12 -
.../data_validation/DescriptiveStatistics.qmd | 2 +-
.../data_validation/IQROutliersBarPlot.qmd | 2 +-
.../ClassifierThresholdOptimization.qmd | 2 +-
site/validmind/validmind/version.qmd | 2 +-
site/validmind/validmind/vm_models.qmd | 36 +-
73 files changed, 10515 insertions(+), 2348 deletions(-)
create mode 100644 site/developer/_sidebar.yaml
create mode 100644 site/notebooks/code_samples/model_validation/validate_application_scorecard.ipynb
create mode 100644 site/notebooks/code_samples/model_validation/xgb_model_champion.pkl
create mode 100644 site/notebooks/code_samples/nlp_and_llm/rag_benchmark_demo.ipynb
rename site/notebooks/tutorials/model_development/{101-set_up_validmind.ipynb => 1-set_up_validmind.ipynb} (90%)
rename site/notebooks/tutorials/model_development/{102-start_development_process.ipynb => 2-start_development_process.ipynb} (87%)
rename site/notebooks/tutorials/model_development/{103-integrate_custom_tests.ipynb => 3-integrate_custom_tests.ipynb} (92%)
rename site/notebooks/tutorials/model_development/{104-finalize_testing_documentation.ipynb => 4-finalize_testing_documentation.ipynb} (94%)
delete mode 100644 site/notebooks/tutorials/model_development/my_tests_directory.png
create mode 100644 site/notebooks/tutorials/model_validation/1-set_up_validmind_for_validation.ipynb
create mode 100644 site/notebooks/tutorials/model_validation/2-start_validation_process.ipynb
create mode 100644 site/notebooks/tutorials/model_validation/3-developing_challenger_model.ipynb
create mode 100644 site/notebooks/tutorials/model_validation/4-finalize_validation_reporting.ipynb
create mode 100644 site/notebooks/tutorials/model_validation/class-imbalance-results-detail.png
create mode 100644 site/notebooks/tutorials/model_validation/compliance-summary.png
create mode 100644 site/notebooks/tutorials/model_validation/inserted-class-imbalance-results.png
create mode 100644 site/notebooks/tutorials/model_validation/inserted-finding.png
create mode 100644 site/notebooks/tutorials/model_validation/inserted-minimum-f1-scores.png
create mode 100644 site/notebooks/tutorials/model_validation/link-finding.png
create mode 100644 site/notebooks/tutorials/model_validation/link-validator-evidence.png
create mode 100644 site/notebooks/tutorials/model_validation/link-validator-evidence_OLD.png
create mode 100644 site/notebooks/tutorials/model_validation/lr_model_champion.pkl
create mode 100644 site/notebooks/tutorials/model_validation/select-finding.png
create mode 100644 site/notebooks/tutorials/model_validation/selecting-class-imbalance-results.png
create mode 100644 site/notebooks/tutorials/model_validation/selecting-minimum-f1-scores.png
diff --git a/site/_quarto.yml b/site/_quarto.yml
index c06596a41c..315500556b 100644
--- a/site/_quarto.yml
+++ b/site/_quarto.yml
@@ -2,6 +2,7 @@ project:
type: website
metadata-files:
+ - developer/_sidebar.yaml
- training/_sidebar.yaml
- validmind/_sidebar.yml
- installation/_sidebar.yaml
@@ -38,7 +39,7 @@ website:
file: get-started/get-started.qmd
- text: "Guides"
file: guide/guides.qmd
- - text: "{{< fa cube >}} Developers"
+ - text: "{{< fa cube >}} {{< var validmind.developer >}}"
menu:
- text: "{{< fa laptop-code >}} {{< var validmind.developer >}}"
file: developer/validmind-library.qmd
@@ -64,15 +65,15 @@ website:
file: https://jupyterhub.validmind.ai/
- text: "---"
- text: "{{< fa book >}} REFERENCE"
- - text: "{{< var validmind.developer >}} API"
+ - text: "{{< var validmind.api >}}"
file: validmind/validmind.qmd
- text: "Support"
file: support/support.qmd
- text: "Training"
file: training/training.qmd
- - text: "validmind.com {{< fa external-link >}}"
- file: https://validmind.com/
- target: _blank
+ # - text: "validmind.com {{< fa external-link >}}"
+ # file: https://validmind.com/
+ # target: _blank
right:
# HOME BUTTON FOR DEVELOPER & TRAINING SECTIONS
- text: "{{< fa house >}}"
@@ -89,17 +90,17 @@ website:
- text: "{{< fa envelope-open-text >}} Support"
file: support/support.qmd
- text: "---"
- - text: "{{< fa cube >}} Developers"
+ - text: "{{< fa cube >}} Python Library"
- text: "{{< fa code >}} {{< var validmind.developer >}}"
file: developer/validmind-library.qmd
- text: "---"
- text: "{{< fa graduation-cap >}} {{< var validmind.training >}}"
- text: "{{< fa building-columns >}} Training Courses"
file: training/training.qmd
- - text: "---"
- - text: "{{< fa square-check >}} validmind.com {{< fa external-link >}}"
- file: https://validmind.com/
- target: _blank
+ # - text: "---"
+ # - text: "{{< fa square-check >}} validmind.com {{< fa external-link >}}"
+ # file: https://validmind.com/
+ # target: _blank
# TRAINING MENU FOR ACADEMY SECTION
- text: "{{< fa graduation-cap >}} Training"
menu:
@@ -324,48 +325,6 @@ website:
- guide/monitoring/review-monitoring-results.qmd
- text: "Metrics over time"
file: guide/monitoring/work-with-metrics-over-time.qmd
-
- - title: "{{< var validmind.developer >}}"
- contents:
- # USING THE VARIABLE IN THE LINK TEXT MESSES UP THE MOBILE VIEW
- - text: "ValidMind Library"
- file: developer/validmind-library.qmd
- - developer/supported-models.qmd
- - text: "---"
- - text: "QuickStart"
- - notebooks/quickstart_customer_churn_full_suite.ipynb
- - text: "Install and initialize ValidMind Library"
- file: developer/model-documentation/install-and-initialize-validmind-library.qmd
- - developer/model-documentation/store-credentials-in-env-file.qmd
- - text: "---"
- - text: "Model Development"
- # USING THE VARIABLE IN THE LINK TEXT MESSES UP THE MOBILE VIEW & BREADCRUMB
- - text: "101 Set up ValidMind Library"
- file: notebooks/tutorials/model_development/101-set_up_validmind.ipynb
- - text: "102 Start model development process"
- file: notebooks/tutorials/model_development/102-start_development_process.ipynb
- - text: "103 Integrate custom tests"
- file: notebooks/tutorials/model_development/103-integrate_custom_tests.ipynb
- - text: "104 Finalize testing & documentation"
- file: notebooks/tutorials/model_development/104-finalize_testing_documentation.ipynb
- - text: "---"
- - text: "Model Testing"
- - text: "Run tests & test suites"
- file: developer/model-testing/testing-overview.qmd
- contents: "notebooks/how_to/**"
- - text: "Test descriptions"
- file: developer/model-testing/test-descriptions.qmd
- contents: tests/**
- - developer/model-testing/test-sandbox.qmd
- - text: "---"
- - text: "Notebooks"
- - text: "Code samples"
- file: developer/samples-jupyter-notebooks.qmd
- contents: "notebooks/code_samples/**"
- - text: "---"
- - text: "Reference"
- - text: "ValidMind Library API"
- file: validmind/validmind.qmd
- title: "Support"
contents:
diff --git a/site/_variables.yml b/site/_variables.yml
index 39e952e001..5df50f021e 100644
--- a/site/_variables.yml
+++ b/site/_variables.yml
@@ -19,7 +19,7 @@ validmind:
developer: "ValidMind Library"
product: "ValidMind AI risk platform"
vpv: "Virtual Private ValidMind"
- api: "Python Library API"
+ api: "ValidMind Library Python API"
legal: "ValidMind Inc."
training: "ValidMind Academy"
diff --git a/site/developer/_metadata.yml b/site/developer/_metadata.yml
index 0be10fd2f4..cb9ee5eeea 100644
--- a/site/developer/_metadata.yml
+++ b/site/developer/_metadata.yml
@@ -1,4 +1,10 @@
format:
html:
+ grid:
+ sidebar-width: 450px
+ margin-width: 450px
page-layout: full
- css: /developer/developer.css
\ No newline at end of file
+ from: markdown-smart
+ css:
+ - /validmind/validmind.css
+ - /developer/developer.css
\ No newline at end of file
diff --git a/site/developer/_sidebar.yaml b/site/developer/_sidebar.yaml
new file mode 100644
index 0000000000..58a7b0a24e
--- /dev/null
+++ b/site/developer/_sidebar.yaml
@@ -0,0 +1,55 @@
+website:
+ sidebar:
+ - id: validmind-library
+ title: "ValidMind Library"
+ contents:
+ # USING THE VARIABLE IN THE LINK TEXT MESSES UP THE MOBILE VIEW
+ - text: "ValidMind Library"
+ file: developer/validmind-library.qmd
+ - developer/supported-models.qmd
+ - text: "---"
+ - text: "QuickStart"
+ - notebooks/quickstart_customer_churn_full_suite.ipynb
+ - text: "Install and initialize ValidMind Library"
+ file: developer/model-documentation/install-and-initialize-validmind-library.qmd
+ - developer/model-documentation/store-credentials-in-env-file.qmd
+ - text: "---"
+ - text: "Model Development"
+ # USING THE VARIABLE IN THE LINK TEXT MESSES UP THE MOBILE VIEW & BREADCRUMB
+ - text: "1 — Set up ValidMind Library"
+ file: notebooks/tutorials/model_development/1-set_up_validmind.ipynb
+ - text: "2 — Start model development process"
+ file: notebooks/tutorials/model_development/2-start_development_process.ipynb
+ - text: "3 — Integrate custom tests"
+ file: notebooks/tutorials/model_development/3-integrate_custom_tests.ipynb
+ - text: "4 — Finalize testing & documentation"
+ file: notebooks/tutorials/model_development/4-finalize_testing_documentation.ipynb
+ - text: "---"
+ - text: "Model Validation"
+ # USING THE VARIABLE IN THE LINK TEXT MESSES UP THE MOBILE VIEW & BREADCRUMB
+ - text: "1 — Set up ValidMind Library for validation"
+ file: notebooks/tutorials/model_validation/1-set_up_validmind_for_validation.ipynb
+ - text: "2 — Start model validation process"
+ file: notebooks/tutorials/model_validation/2-start_validation_process.ipynb
+ - text: "3 — Developing a challenger model"
+ file: notebooks/tutorials/model_validation/3-developing_challenger_model.ipynb
+ - text: "4 — Finalize validation & reporting"
+ file: notebooks/tutorials/model_validation/4-finalize_validation_reporting.ipynb
+ - text: "---"
+ - text: "Model Testing"
+ - text: "Run tests & test suites"
+ file: developer/model-testing/testing-overview.qmd
+ contents: "notebooks/how_to/**"
+ - text: "Test descriptions"
+ file: developer/model-testing/test-descriptions.qmd
+ contents: tests/**
+ - developer/model-testing/test-sandbox.qmd
+ - text: "---"
+ - text: "Notebooks"
+ - text: "Code samples"
+ file: developer/samples-jupyter-notebooks.qmd
+ contents: "notebooks/code_samples/**"
+ - text: "---"
+ - text: "Reference"
+ - text: "{{< var validmind.api >}}"
+ file: validmind/validmind.qmd
diff --git a/site/developer/validmind-library.qmd b/site/developer/validmind-library.qmd
index 8cc5b7e984..818d657eff 100644
--- a/site/developer/validmind-library.qmd
+++ b/site/developer/validmind-library.qmd
@@ -16,9 +16,9 @@ listing:
grid-columns: 2
contents:
- ../notebooks/quickstart_customer_churn_full_suite.ipynb
- - path: https://www.youtube.com/watch?v=rIR8Mql7eGs
+ - path: https://youtu.be/rIR8Mql7eGs
title: "{{< fa brands youtube >}} {{< var vm.product >}} QuickStart"
- description: "Watch the walkthrough on YouTube: `https://www.youtube.com/watch?v=rIR8Mql7eGs`"
+ description: "Watch the walkthrough on YouTube: `https://youtu.be/rIR8Mql7eGs`"
# - ../notebooks/tutorials/intro_for_model_developers.ipynb
# - developer-getting-started-video.qmd
- id: model-development
@@ -26,18 +26,35 @@ listing:
grid-columns: 2
max-description-length: 250
contents:
- - path: ../notebooks/tutorials/model_development/101-set_up_validmind.ipynb
- title: "101 Set up the {{< var validmind.developer >}}"
- description: "Get to know {{< var vm.product >}} by setting up the {{< var validmind.developer >}} in your own environment and registering a sample binary classification model in the {{< var validmind.platform >}} for use with this series of notebooks."
- - path: ../notebooks/tutorials/model_development/102-start_development_process.ipynb
- title: "102 Start the model development process"
+ - path: ../notebooks/tutorials/model_development/1-set_up_validmind.ipynb
+ title: "1 — Set up the {{< var validmind.developer >}}"
+ description: "Get to know {{< var vm.product >}} by setting up the {{< var validmind.developer >}} in your own environment, and registering a sample binary classification model in the {{< var validmind.platform >}} for use with this series of notebooks."
+ - path: ../notebooks/tutorials/model_development/2-start_development_process.ipynb
+ title: "2 — Start the model development process"
description: "Learn to run and log tests with a variety of methods and in different situations with the {{< var validmind.developer >}}, then add the results or evidence to your documentation for the sample model you registered."
- - path: ../notebooks/tutorials/model_development/103-integrate_custom_tests.ipynb
- title: "103 Integrate custom tests"
+ - path: ../notebooks/tutorials/model_development/3-integrate_custom_tests.ipynb
+ title: "3 — Integrate custom tests"
description: "After you become familiar with the basics of the {{< var validmind.developer >}}, learn how to supplement ValidMind tests with your own and include them as additional evidence in your documentation. "
- - path: ../notebooks/tutorials/model_development/104-finalize_testing_documentation.ipynb
- title: "104 Finalize testing and documentation"
+ - path: ../notebooks/tutorials/model_development/4-finalize_testing_documentation.ipynb
+ title: "4 — Finalize testing and documentation"
description: "Wrap up by learning how to ensure that custom tests are included in your model's documentation template. By the end of this series, you will have a fully documented sample model ready for review."
+ - id: model-validation
+ type: grid
+ grid-columns: 2
+ max-description-length: 250
+ contents:
+ - path: ../notebooks/tutorials/model_validation/1-set_up_validmind_for_validation.ipynb
+ title: "1 — Set up the {{< var validmind.developer >}} for validation"
+ description: "Get to know {{< var vm.product >}} by setting up the {{< var validmind.developer >}} in your own environment, and gaining access as a validator to a sample model in the {{< var validmind.platform >}} for use with this series of notebooks."
+ - path: ../notebooks/tutorials/model_validation/2-start_validation_process.ipynb
+ title: "2 — Start the model validation process"
+ description: "Independently verify the data quality tests performed on datasets used to train the dummy champion model using tests from the {{< var validmind.developer >}}, then add the results or evidence to your validation report."
+ - path: ../notebooks/tutorials/model_validation/3-developing_challenger_model.ipynb
+ title: "3 — Developing a potential challenger model"
+ description: "After you become familiar with the basics of the {{< var validmind.developer >}}, use it to develop a potential challenger model and run thorough model comparison tests, such as performance, diagnostic, and feature importance tests."
+ - path: ../notebooks/tutorials/model_validation/4-finalize_validation_reporting.ipynb
+ title: "4 — Finalize validation and reporting"
+ description: "Wrap up by learning how to include custom tests and verifying that all tests conducted during model development were run and reported accurately. By the end of this series, you will have a validation report complete with findings ready for review."
- id: run-tests
grid-columns: 2
type: grid
@@ -63,7 +80,7 @@ listing:
max-description-length: 250
sort: false
fields: [title, description]
- contents:
+ contents:
- ../guide/model-documentation/work-with-test-results.qmd
- ../guide/model-documentation/work-with-content-blocks.qmd
---
@@ -73,12 +90,12 @@ The {{< var validmind.developer >}} helps you streamline model documentation by
## What is the {{< var validmind.developer >}}?
The {{< var validmind.developer >}} provides a rich collection of documentation tools and test suites, from documenting descriptions of your dataset to validation testing your models for weak spots and overfit areas.
-
+
{{< var vm.product >}} offers two primary methods for automating model documentation:
-- **Generate documentation** — Through automation, the {{< var vm.developer >}} extracts metadata from associated datasets and models for you and generates model documentation based on a template. You can also add more documentation and tests manually using the documentation editing capabilities in the {{< var validmind.platform >}}.
+- **Generate documentation**[^1] — Through automation, the {{< var vm.developer >}} extracts metadata from associated datasets and models for you and generates model documentation based on a template. You can also add more documentation and tests manually using the documentation editing capabilities in the {{< var validmind.platform >}}.
-- **Run validation tests** — The {{< var vm.developer >}} provides a suite of validation tests for common financial services use cases. For cases where these tests do not cover everything you need, you can also extend existing test suites with your own proprietary tests or testing providers.
+- **Run validation tests**[^2] — The {{< var vm.developer >}} provides a suite of validation tests for common financial services use cases. For cases where these tests do not cover everything you need, you can also extend existing test suites with your own proprietary tests or testing providers.
The {{< var validmind.developer >}} is designed to be model agnostic. If your model is built in Python, the {{< var vm.developer >}} provides all the standard functionality you may need without requiring you to rewrite any functions.
@@ -98,6 +115,8 @@ After you [**sign up**](/guide/configuration/accessing-validmind.qmd) for {{< va
:::{#library-quickstart}
:::
+
+
## {{< var vm.product >}} for model development
Learn how to use ValidMind for your end-to-end model documentation process based on common model development scenarios with our *ValidMind for model development* series of four introductory notebooks:
@@ -105,17 +124,26 @@ Learn how to use ValidMind for your end-to-end model documentation process based
:::{#model-development}
:::
+
+
+## {{< var vm.product >}} for model validation
+
+Learn how to use ValidMind for your end-to-end model validation process based on common scenarios with our *ValidMind for model validation* series of four introductory notebooks:
+
+:::{#model-validation}
+:::
+
## Learn how to run tests
:::: {.flex .flex-wrap .justify-around}
-::: {.w-80-ns}
-The {{< var validmind.developer >}} provides many built-in tests and test suites which make it easy for developers to automate their model documentation. Start by running a pre-made test, then modify it, and finally create your own test:
+::: {.w-70-ns}
+The {{< var validmind.developer >}} provides many built-in tests and test suites which make it easy for developers to automate their model documentation. Start by running a pre-made test, then modify it, and finally create your own test:
:::
-::: {.w-20-ns .tc}
+::: {.w-30-ns .tc}
[Run tests & test suites](model-testing/testing-overview.qmd){.button .button-green}
:::
@@ -129,12 +157,12 @@ The {{< var validmind.developer >}} provides many built-in tests and test suites
:::: {.flex .flex-wrap .justify-around}
-::: {.w-80-ns}
+::: {.w-70-ns}
Our code samples showcase the capabilities of the {{< var validmind.developer >}}. Examples that you can build on and adapt for your own use cases include:
:::
-::: {.w-20-ns .tc}
+::: {.w-30-ns .tc}
[All code samples](samples-jupyter-notebooks.qmd){.button .button-green}
:::
@@ -148,12 +176,12 @@ Our code samples showcase the capabilities of the {{< var validmind.developer >}
:::: {.flex .flex-wrap .justify-around}
-::: {.w-70-ns}
+::: {.w-60-ns}
After you have tried out the {{< var validmind.developer >}}, continue working with your model documentation in the {{< var validmind.platform >}}:
:::
-::: {.w-30-ns .tc}
+::: {.w-40-ns .tc}
[Working with model documentation](/guide/model-documentation/working-with-model-documentation.qmd){.button .button-green}
:::
@@ -161,4 +189,11 @@ After you have tried out the {{< var validmind.developer >}}, continue working w
::::
:::{#library-documentation}
-:::
\ No newline at end of file
+:::
+
+
+
+
+[^1]: [{{< var vm.product >}} for model development](#development)
+
+[^2]: [{{< var vm.product >}} for model validation](#validation)
\ No newline at end of file
diff --git a/site/notebooks.zip b/site/notebooks.zip
index 3daf454cabfe04d69f6a673edae8c3d7c66beae1..6190e6637cf08dfc9ff8016f6fde747ae6164ae9 100644
GIT binary patch
delta 2451565
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
z
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