aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFabio Berger <me@fabioberger.com>2018-04-19 10:56:41 +0800
committerFabio Berger <me@fabioberger.com>2018-04-19 10:56:41 +0800
commit1a0d68d49a066d4624677eab518bdca0e6603fe3 (patch)
tree30f3f575484ddcac63543e4708738ccd790b6cbe
parent7dd3b2d38b4e4ee2f1daa24c90f503b2e7ad0422 (diff)
downloaddexon-sol-tools-1a0d68d49a066d4624677eab518bdca0e6603fe3.tar
dexon-sol-tools-1a0d68d49a066d4624677eab518bdca0e6603fe3.tar.gz
dexon-sol-tools-1a0d68d49a066d4624677eab518bdca0e6603fe3.tar.bz2
dexon-sol-tools-1a0d68d49a066d4624677eab518bdca0e6603fe3.tar.lz
dexon-sol-tools-1a0d68d49a066d4624677eab518bdca0e6603fe3.tar.xz
dexon-sol-tools-1a0d68d49a066d4624677eab518bdca0e6603fe3.tar.zst
dexon-sol-tools-1a0d68d49a066d4624677eab518bdca0e6603fe3.zip
Add descriptions for all commands in monorepo-scripts
-rw-r--r--packages/monorepo-scripts/README.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/packages/monorepo-scripts/README.md b/packages/monorepo-scripts/README.md
index a740ba28a..1bfa1b0d8 100644
--- a/packages/monorepo-scripts/README.md
+++ b/packages/monorepo-scripts/README.md
@@ -2,6 +2,16 @@
This repository contains a few helpful scripts for working with this mono repo.
+#### Scripts
+
+**`yarn deps_versions`**: Since we use Lerna + yarn workspaces, shared dependencies between packages in the monorepo get hoisted to a top-level `node_modules` directory. If two packages use different versions of the same dependency however, both get installed. To avoid having many versions of a dependency installed, we try to keep dependency versions the same across packages in the monorepo. This script will list any dependencies for which we have multiple versions installed. We can then go through them and try to consolidate to a single version where possible.
+
+**`yarn find_unused_deps`**: Sometimes we accidentally leave dependencies listed in `package.json` that are no longer being used. This script finds potential dependencies that might no longer be in use. Please verify that it is no longer in use before removing, the `depcheck` package we use under-the-hood doesn't handle some TS quirks perfectly.
+
+**`yarn remove_tags`**: Our publishing script calls `lerna publish` under-the-hood. If this command fails, it might have created new versioned git tags for each package. Removing these manually is tedious, so you can also run this command instead. Before doing so, check to see if `lerna` already created the publish commit. If so, first revert that with `git reset --hard HEAD~1`, then run this command.
+
+**`yarn test:publish`**: Execute a test-run of the publish script. This dry run won't actually publish, nor will it commit/push anything to Github.
+
## Usage
#### Dependency versions