Products organizations must build robust product plans from competitive and customer interactions everyone can see, use, and reference. Therefore, Mediumroast for GitHub intends to help Products oranizations construct an active interactions repository close to the action of development and issue management in GitHub.
- A new version of the CLI is available and documentation is in progress. The major focus of this version is to add in Competitive Similarity Analysis, Interaction summarization and Interaction Proto-requirements discovery.
- You can review the GitHub Page Version rather than the repository version of this documentation, but the screencasts of several of the CLI tutorials will not display.
Mediumroast for GitHub includes a GitHub Application, a Command Line Interface, and a Software Development Kit. The following steps show you how to install the App and the CLI with SDK.
- A GitHub organization
- Permissions in your GitHub organization to install a GitHub application.
- Access to a command line terminal on Linux or MacOS.
- Node.js installed, ideally globally for all users.
- NPM installed, ideally globally for all users.
Browse to the Mediumroast for GitHub GitHub Application and:
- Click install,
- Choose the location for the installation, usually your organization,
- Confirm the requested permissions, and
- Browse to your organization's
Settings > Third-Party Access > GitHub Apps
and confirm that Mediumroast for GitHub is installed.
This package mediumroast_js can be installed and removed via npm
, several ways to install follow.
Assuming the preinstallation requirements, installation of node.js and npm, are met please one one of the following.
- Global installation for all users:
sudo npm i -g mediumroast_js
- Local installation for a developer or single user:
npm i mediumroast_js
Coming soon.
Before you can use the Mediumroast for GitHub CLI the environment must be setup. With the CLI installed please run mrcli setup
to start the setup process, note there's a video of the setup process in CLI README.
Running mrcli setup
creates a repository in your oganization called <organization_name>_discovery
to contain all interactions and companies, creates two intitial companies, and installs two GitHub Actions to control the number of branches and provide some basic out of the box reporting -- see example screenshot below.
Since Mediumroast for GitHub creates a regular repository you can interact with it as normal, but doing so is not recommended. If you interact with the repository, in regular ways, this could result in Mediumroast for GitHub becoming inoperable. There are cases where it may become necessary to directly work with the repository, but that should be rare.
If you detect a problem or want to suggest an improvement open an issue and we will work with you to resolve or respond.