ed-tech-utilities

Contains all utility packages managed by editorial-tech

Getting started

A new utility package can be generate with Q-cli:

Q new-et-utils-package package-name "package author" "package description"

The directory name where the new ed-tech utility package project is being created defaults to the project name and can be overwritten by using option -d or --dir

Q new-et-utils-package package-name -d my-project-directory

NOTE: Sometimes the .gitignore & .npmignore do not get copied over

Run npm install from package folder

cd <package-folder>
npm install

Development

cd <package-folder>
npm run start

Testing

cd <package-folder>
npm run test

Publication Process

For each npm package release we do a ed-tech-utilities repository release. This allows for easy tracking of commits related to either package name/version or repository version.

Create a PR from your fix- or feature-branch to main. Maybe have another team member do a code-review. Merge the PR.
Pull your changes and cd <package-folder>
Update the version in the package.json file
npm publish (automatically runs tests, typescript compiler & rollup bundler)
Commit the new build and updated package.json
Go to GitHub Repo Releases
Create a new release with raised utility repo version as title <package-name>-v<package-version-number> (raise by change severity of package, e.g.tracking-v1.1.3)
Add the tag <package-name>-<package-version-number> (e.g. date-1.0.3)
Add release description or point to package readme (if changes are documented)

Install Package