Committing changes

Jargon uses a version control system to store your content. When you first edit content, your changes are only visible to you. To deploy those changes to your application and make them visible to the other people invited to the project, click “Commit My Changes” in the top toolbar. You can add an optional message describing your changes.

Reviewing changes

Use the “Get Latest” button (to the left of the “Commit My Changes” button) to incorporate changes that other people on the project have committed. Note that if you’re behind on changes you need to click “Get Latest” before you can commit your changes.

You can see a history of changes made under the content editor of a specific component. "The "Compare It" button to the right of each commit will allow you to see a comparison between the current version and that specific commit."

Creating a release

A Jargon release takes the committed content for a project, validates that it doesn’t contain any errors, and converts it into a “content package” that your app can call at runtime. You also have the option to download the content package to manage offline.

To create a release:

  1. Select “Releases” on the top navigation bar.
  2. Click the “Create Release” button.
  3. Select the platforms and locales the release is for. This allows you to skip things that may not be ready yet.

You’ll see a progress indicator while the release is building; this will update automatically when the build finishes. If your project contains any errors, the build will fail. Click “Show info” for details on what needs fixing. If the release is successful, information needed for app configuration will be provided on the screen.

Click “Show info” to view:

  • The Jargon Project ID
  • The “Content Interface ID”. This ID changes whenever the structure of your content changes (that is, when responses and response components are added or deleted). It’s used to ensure that the Jargon content servers return content that’s compatible with your application.

Deploying a release

Once a release has been successfully built, you can deploy it to Jargon’s content servers:

  1. For the release you want to deploy, click the up arrow in the “Deployment” column on the right side.
  2. You can optionally add one or more “Tags” to identify the environment(s) the content is for. Tags allow you to first have content accessible to a development or staging environment, and later promote that content to a production environment. Note that you can add new tags to a deployment, but that it’s not possible to remove a tag once added. To add a tag type and the desired tag name, click the “+” to the right of the input field.
  3. Once you’ve added any desired tags, click “Create” to create the deployment. Within a few moments, Jargon’s content servers will load the new content and have it ready to serve.