From b1bceb2d744f5b2be2ebdcd3a53ec3a71028f833 Mon Sep 17 00:00:00 2001 From: Avi Press Date: Mon, 30 Dec 2024 10:00:41 -0500 Subject: [PATCH] MTC docs (#186) * fix build * MTC docs * Update mtc.md --- README.md | 10 --- devenv.lock | 156 ----------------------------------------------- devenv.nix | 18 ------ devenv.yaml | 3 - docs/mtc.md | 38 ++++++++++++ mkdocs.yml | 4 +- requirements.txt | 5 +- 7 files changed, 44 insertions(+), 190 deletions(-) delete mode 100644 devenv.lock delete mode 100644 devenv.nix delete mode 100644 devenv.yaml create mode 100644 docs/mtc.md diff --git a/README.md b/README.md index 93b748b..1a1c3f6 100644 --- a/README.md +++ b/README.md @@ -23,16 +23,6 @@ pip install -r requirements.txt mkdocs serve ``` -#### [devenv.sh](https://devenv.sh) - -```bash -# drop into a shell with dependencies installed -devenv shell - -# run the dev server -devenv up -``` - ### Deploy GitHub Actions are configured for this repository to deploy changes on every update to the master branch. diff --git a/devenv.lock b/devenv.lock deleted file mode 100644 index f428e35..0000000 --- a/devenv.lock +++ /dev/null @@ -1,156 +0,0 @@ -{ - "nodes": { - "devenv": { - "locked": { - "dir": "src/modules", - "lastModified": 1714390914, - "owner": "cachix", - "repo": "devenv", - "rev": "34e6461fd76b5f51ad5f8214f5cf22c4cd7a196e", - "treeHash": "5c5dc481030d6e30f8aa506e6d0c0d0809490d65", - "type": "github" - }, - "original": { - "dir": "src/modules", - "owner": "cachix", - "repo": "devenv", - "type": "github" - } - }, - "flake-compat": { - "flake": false, - "locked": { - "lastModified": 1696426674, - "owner": "edolstra", - "repo": "flake-compat", - "rev": "0f9255e01c2351cc7d116c072cb317785dd33b33", - "treeHash": "2addb7b71a20a25ea74feeaf5c2f6a6b30898ecb", - "type": "github" - }, - "original": { - "owner": "edolstra", - "repo": "flake-compat", - "type": "github" - } - }, - "flake-utils": { - "inputs": { - "systems": "systems" - }, - "locked": { - "lastModified": 1710146030, - "owner": "numtide", - "repo": "flake-utils", - "rev": "b1d9ab70662946ef0850d488da1c9019f3a9752a", - "treeHash": "bd263f021e345cb4a39d80c126ab650bebc3c10c", - "type": "github" - }, - "original": { - "owner": "numtide", - "repo": "flake-utils", - "type": "github" - } - }, - "gitignore": { - "inputs": { - "nixpkgs": [ - "pre-commit-hooks", - "nixpkgs" - ] - }, - "locked": { - "lastModified": 1709087332, - "owner": "hercules-ci", - "repo": "gitignore.nix", - "rev": "637db329424fd7e46cf4185293b9cc8c88c95394", - "treeHash": "ca14199cabdfe1a06a7b1654c76ed49100a689f9", - "type": "github" - }, - "original": { - "owner": "hercules-ci", - "repo": "gitignore.nix", - "type": "github" - } - }, - "nixpkgs": { - "locked": { - "lastModified": 1704290814, - "owner": "NixOS", - "repo": "nixpkgs", - "rev": "70bdadeb94ffc8806c0570eb5c2695ad29f0e421", - "treeHash": "a0ee02eceb71106d608605419182d174044030d9", - "type": "github" - }, - "original": { - "owner": "NixOS", - "ref": "nixos-23.05", - "repo": "nixpkgs", - "type": "github" - } - }, - "nixpkgs-stable": { - "locked": { - "lastModified": 1714272655, - "owner": "NixOS", - "repo": "nixpkgs", - "rev": "12430e43bd9b81a6b4e79e64f87c624ade701eaf", - "treeHash": "e76ecc257d4f76a36a0ec6e4f779fc35aecadf7b", - "type": "github" - }, - "original": { - "owner": "NixOS", - "ref": "nixos-23.11", - "repo": "nixpkgs", - "type": "github" - } - }, - "pre-commit-hooks": { - "inputs": { - "flake-compat": "flake-compat", - "flake-utils": "flake-utils", - "gitignore": "gitignore", - "nixpkgs": [ - "nixpkgs" - ], - "nixpkgs-stable": "nixpkgs-stable" - }, - "locked": { - "lastModified": 1713954846, - "owner": "cachix", - "repo": "pre-commit-hooks.nix", - "rev": "6fb82e44254d6a0ece014ec423cb62d92435336f", - "treeHash": "a456512c8da29752b79131f1e5b45053e2394078", - "type": "github" - }, - "original": { - "owner": "cachix", - "repo": "pre-commit-hooks.nix", - "type": "github" - } - }, - "root": { - "inputs": { - "devenv": "devenv", - "nixpkgs": "nixpkgs", - "pre-commit-hooks": "pre-commit-hooks" - } - }, - "systems": { - "locked": { - "lastModified": 1681028828, - "owner": "nix-systems", - "repo": "default", - "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e", - "treeHash": "cce81f2a0f0743b2eb61bc2eb6c7adbe2f2c6beb", - "type": "github" - }, - "original": { - "owner": "nix-systems", - "repo": "default", - "type": "github" - } - } - }, - "root": "root", - "version": 7 -} diff --git a/devenv.nix b/devenv.nix deleted file mode 100644 index 0f2295d..0000000 --- a/devenv.nix +++ /dev/null @@ -1,18 +0,0 @@ -{ pkgs, ... }: - -{ - env.GREET = "devenv"; - - packages = [ - pkgs.git - ]; - - enterShell = '' - pip install -r requirements.txt - ''; - - languages.python.enable = true; - languages.python.venv.enable = true; - - processes.serve.exec = "mkdocs serve"; -} diff --git a/devenv.yaml b/devenv.yaml deleted file mode 100644 index 16bc082..0000000 --- a/devenv.yaml +++ /dev/null @@ -1,3 +0,0 @@ -inputs: - nixpkgs: - url: github:NixOS/nixpkgs/nixos-23.05 diff --git a/docs/mtc.md b/docs/mtc.md new file mode 100644 index 0000000..b9c9251 --- /dev/null +++ b/docs/mtc.md @@ -0,0 +1,38 @@ +# Monthly Tracked Companies (MTCs) + +Scarf identifies which companies are viewing your documents, downloading your packages, or executing your software, and tracks their activity across the organization. These are referred to as Monthly Tracked Companies (MTCs). Scarf enriches IP addresses with several metadata sources to provide the most accurate data possible. + +## Consumption of MTCs +MTCs are consumed any time a company is seen for the first time in a given month. For example, if you have purchased 100 MTCs, you will see the first 100 companies that interact with your open source and no further companies will be surfaced for the remainder of the month. + +NOTE: There is no way to predict which companies will surface, or how quickly. Companies are surfaced in the order they are seen, until your MTC limit is reached. + +Scarf will always show you the total number of companies interacting with your project at the bottom of the Company Insights page. You can update your plan's MTC quota in your Organization settings. You can also track your MTC usage by day in your Organization settings. + +## Match Feedback +Match Feedback allows you to confirm, deny, or fix your company matches. Companies marked with negative match feedback will not consume MTCs the following month. + +![No company feedback on file If you](https://github.com/user-attachments/assets/72389329-b857-45b2-9450-481e45badc39) + +## FAQ +Q: How do I know how much of my MTC quota I’ve used? +A: You will see a count of the currently used MTCs at the bottom of the Company Insights page. + +![AD_4nXcJB4vyNmsG0v4KrNp82PMYOXX86ixbaBe2Yqn5C1uJ471Lt0eNeATdBn-GHOSjVVK19DSze9bOT75QA5QpJYSGlqGsJ1nrS4Jd050W_KcBITvGQCjOt7gL](https://github.com/user-attachments/assets/641e30b6-293d-415c-add9-4e0d772a88a6) + +It is also available on the Organization settings page. + +![1,048](https://github.com/user-attachments/assets/191f5115-c31d-4acd-965c-475fb41773f5) +![MTC Consumption is based on the number of matched companies in a 30 day period This chart shows the](https://github.com/user-attachments/assets/b749dd9e-d269-4631-a0fa-8680057b4408) + + +Q: What if I want to see more companies? +A: You can always increase the number of MTCs on your account to see more. If you are using the Scarf Starter package you can add up to 250 MTCs by going into your account Settings > Billing/Subscription and adding more. If you are using any other Scarf package, contact sales or your customer success manager for more information. + +![Upgrade your MTC limit](https://github.com/user-attachments/assets/e1c121d2-d5dc-434d-a39d-bdeca9e1d694) + +Q: Why do I occasionally see fewer companies on my Scarf home page than I am allocated? +A: Scarf’s home page will always show you metrics from the last 30 days. Because the MTC quota resets at the beginning of each month, there is sometimes a perceived “gap” in the number of companies shown on the home page in the “Events by Company” chart. While the home page is designed to provide an “at-a-glance” overview of overall activity, it may be easier to get the full picture of the companies present within a given period (within the MTC quota) by visiting the Company Insights page. + +Q: When I look at the results on the Company Insights page for last month (using the custom time range), I see that 3,045 of my 5,000 allocated companies are being shown. Why do I not see all 5,000 of my MTCs? +A: Scarf displays the companies present at that point in time that are also present in the current month’s quota. In other words, 3,045 of the companies present last month are also in this month’s data. The remaining companies we matched last month are inactive in the current month’s data. As companies interact with your project in that given month, they will be added to the count until you reach your full MTC quota. diff --git a/mkdocs.yml b/mkdocs.yml index a5ea626..bb70e1a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -44,7 +44,9 @@ nav: - getting-started-checklist.md - quick-start.md - gateway.md -- organizations.md +- Organizations: + - Setting up your organization: organizations.md + - mtc.md - packages.md - package-analytics.md - custom-telemetry.md diff --git a/requirements.txt b/requirements.txt index ce8958a..1752d4b 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,4 +1,5 @@ -mkdocs==1.4.2 -mkdocs-material==9.0.6 +mkdocs>=1.4.2 +mkdocs-material>=9.0.6 mkdocs_custom_fences mkdocs-render-swagger-plugin>=0.0.4 +pyyaml>=6.0