diff --git a/docs/Overview.md b/docs/Overview.md index eb1e15cb9..77d926b9a 100644 --- a/docs/Overview.md +++ b/docs/Overview.md @@ -24,8 +24,8 @@ N1 is available for Mac, Windows, and Linux. Download the latest build for your Packages lie at the heart of N1. Each part of the core experience is a separate package that uses the Nylas Package API to add functionality to the client. Learn more about packages and create your first package.

diff --git a/docs/WritingSpecs.md b/docs/WritingSpecs.md index 1562ade00..b708ff0f6 100644 --- a/docs/WritingSpecs.md +++ b/docs/WritingSpecs.md @@ -11,7 +11,7 @@ This documentation describes using [Jasmine 1.3](http://jasmine.github.io/1.3/in ### Running Specs -You can run your package specs from `Developer > Run Package Specs...`. Once you've opened the spec window, you can see output and re-run your specs by clicking `Reload Specs`. +You can run your package specs from `Developer > Run Plugin Specs...`. Once you've opened the spec window, you can see output and re-run your specs by clicking `Reload Specs`. ### Writing Specs diff --git a/docs/index.md b/docs/index.md index 8fdd870a3..e31dc3dd4 100644 --- a/docs/index.md +++ b/docs/index.md @@ -79,8 +79,8 @@ blockquote p {
-

2
Start a Package

-

Packages lie at the heart of N1. The thread list, composer and other core parts of the app are packages bundled with the app, and you have access to the same set of APIs. From the Developer Menu, choose Create a Package... and name your new package.

+

2
Start a Plugin

+

Plugins lie at the heart of N1. The thread list, composer and other core parts of the app are plugins bundled with the app, and you have access to the same set of APIs. From the Developer Menu, choose Create a Plugin... and name your new plugin.

@@ -90,7 +90,7 @@ blockquote p {

3
See it in Action

-

Your new package comes with some basic code that adds a section to the message sidebar, and it's already enabled! View a message to see it in action. If you make changes to the source, choose View > Refresh to see your changes in N1.

+

Your new plugin comes with some basic code that adds a section to the message sidebar, and it's already enabled! View a message to see it in action. If you make changes to the source, choose View > Refresh to see your changes in N1.

@@ -98,7 +98,7 @@ blockquote p {
-

Step 2: Build your first package

+

Step 2: Build your first plugin

@@ -108,28 +108,28 @@ blockquote p {

A
Explore the source

-

Nylas is built on the modern web - packages are written in CoffeeScript or JavaScript. Packages are a lot like node modules, with their own source, assets, and tests. Check out yours in ~/.nylas/dev/packages.

+

Nylas is built on the modern web - plugins are written in CoffeeScript or JavaScript. Plugins are a lot like node modules, with their own source, assets, and tests. Check out yours in ~/.nylas/dev/packages.

B
Run the specs

-

In N1, select Developer > Run Package Specs... from the menu to run your package's new specs. Nylas and its packages use the Jasmine testing framework.

+

In N1, select Developer > Run Plugin Specs... from the menu to run your plugin's new specs. Nylas and its plugins use the Jasmine testing framework.

-

Step 3: Building your first package

+

Step 3: Building your first plugin

-If you followed the [first part](getting-started) of our Getting Started Guide, you should have a brand new package just waiting to be explored. +If you followed the [first part](getting-started) of our Getting Started Guide, you should have a brand new plugin just waiting to be explored. -This sample package simply adds the name of the currently focused contact to the sidebar: +This sample plugin simply adds the name of the currently focused contact to the sidebar: -We're going to build on this to show the sender's [Gravatar](http://gravatar.com) image in the sidebar, instead of just their name. You can check out the full code for the package [in the sample packages repository](https://github.com/nylas/edgehill-plugins/tree/master/sidebar-gravatar). +We're going to build on this to show the sender's [Gravatar](http://gravatar.com) image in the sidebar, instead of just their name. You can check out the full code for the plugin [in the sample plugins repository](https://github.com/nylas/edgehill-plugins/tree/master/sidebar-gravatar). -Find the package source in `~/.nylas/dev/packages` and open the contents in your favorite text editor. +Find the plugin source in `~/.nylas/dev/plugins` and open the contents in your favorite text editor. -> We use [CJSX](https://github.com/jsdf/coffee-react), a [CoffeeScript](http://coffeescript.org/) syntax for [JSX](https://facebook.github.io/react/docs/jsx-in-depth.html), to streamline our package code. +> We use [CJSX](https://github.com/jsdf/coffee-react), a [CoffeeScript](http://coffeescript.org/) syntax for [JSX](https://facebook.github.io/react/docs/jsx-in-depth.html), to streamline our plugin code. For syntax highlighting, we recommend [Babel](https://github.com/babel/babel-sublime) for Sublime, or the [CJSX Language](https://atom.io/packages/language-cjsx) Atom package. ### Changing the data @@ -149,13 +149,13 @@ _renderContent: =>
``` -After making changes to the package, reload N1 by going to `View > Reload`. +After making changes to the plugin, reload N1 by going to `View > Reload`. ### Installing a dependency Now we've figured out how to show the contact's email address, we can use that to generate the [Gravatar](http://gravatar.com) for the contact. However, as per the [Gravatar documentation](https://en.gravatar.com/site/implement/images/), we need to be able to calculate the MD5 hash for an email address first. -Let's install the `md5` package and save it as a dependency in our `package.json`: +Let's install the `md5` plugin and save it as a dependency in our `package.json`: ```bash $ npm install md5 --save @@ -229,11 +229,11 @@ You'll see these styles reflected in your sidebar. -If you're a fan of using the Chrome Developer Tools to tinker with styles, no fear; they work in N1, too. Open them by going to `Developer > Toggle Developer Tools`. You'll also find them helpful for debugging in the event that your package isn't behaving as expected. +If you're a fan of using the Chrome Developer Tools to tinker with styles, no fear; they work in N1, too. Open them by going to `Developer > Toggle Developer Tools`. You'll also find them helpful for debugging in the event that your plugin isn't behaving as expected.
-

Continue this guide: adding a data store to your package

+

Continue this guide: adding a data store to your plugin

@@ -263,7 +263,7 @@ We've already used this (without realizing) in the [Gravatar sidebar example](ge In this case, the sidebar listens to the `FocusedContactsStore`, which updates when the person selected in the conversation changes. This triggers the `_onChange` method which updates the component state; this causes React to render the view with the new state. -To add more depth to our sidebar package, we need to: +To add more depth to our sidebar plugin, we need to: * Create our own data store which will listen to `FocusedContactsStore` * Extend our data store to do additional things with the contact data @@ -369,6 +369,6 @@ For example: ## Extending The Store -To make this package more compelling, we can extend the store to make further API requests and fetch more data about the user. Passing this data back to the UI component follows exactly the same pattern as the barebones data shown above, so we'll leave it as an exercise for the reader. :) +To make this plugin more compelling, we can extend the store to make further API requests and fetch more data about the user. Passing this data back to the UI component follows exactly the same pattern as the barebones data shown above, so we'll leave it as an exercise for the reader. :) -> You can find a more extensive version of this example in our [sample packages repository](https://github.com/nylas/edgehill-plugins/tree/master/sidebar-github-profile). +> You can find a more extensive version of this example in our [sample plugins repository](https://github.com/nylas/edgehill-plugins/tree/master/sidebar-github-profile). diff --git a/menus/darwin.cson b/menus/darwin.cson index 70fe3b248..6bae32997 100644 --- a/menus/darwin.cson +++ b/menus/darwin.cson @@ -63,10 +63,10 @@ { type: 'separator' } { label: 'Open Activity Window', command: 'application:show-work-window' } { type: 'separator' } - { label: 'Create a Package...', command: 'application:create-package' } - { label: 'Install a Package Manually...', command: 'application:install-package' } + { label: 'Create a Plugin...', command: 'application:create-package' } + { label: 'Install a Plugin Manually...', command: 'application:install-package' } { type: 'separator' } - { label: 'Run Package Specs...', command: 'application:run-package-specs' } + { label: 'Run Plugin Specs...', command: 'application:run-package-specs' } { label: 'Run N1 Specs', command: 'application:run-all-specs' } { type: 'separator' } { label: 'Open Detailed Logs', command: 'window:open-errorreporter-logs' } diff --git a/menus/linux.cson b/menus/linux.cson index e15d64eee..3c82dd771 100644 --- a/menus/linux.cson +++ b/menus/linux.cson @@ -43,10 +43,10 @@ { type: 'separator' } { label: 'Open Activity Window', command: 'application:show-work-window' } { type: 'separator' } - { label: 'Create a Package...', command: 'application:create-package' } - { label: 'Install a Package Manually...', command: 'application:install-package' } + { label: 'Create a Plugin...', command: 'application:create-package' } + { label: 'Install a Plugin Manually...', command: 'application:install-package' } { type: 'separator' } - { label: 'Run Package &Specs...', command: 'application:run-package-specs' } + { label: 'Run Plugin &Specs...', command: 'application:run-package-specs' } { label: 'Run &N1 Specs', command: 'application:run-all-specs' } { type: 'separator' } { label: 'Open Detailed Logs', command: 'window:open-errorreporter-logs' } diff --git a/menus/win32.cson b/menus/win32.cson index 8ec0e2f48..e28ca4253 100644 --- a/menus/win32.cson +++ b/menus/win32.cson @@ -32,10 +32,10 @@ { type: 'separator' } { label: 'Open Activity Window', command: 'application:show-work-window' } { type: 'separator' } - { label: 'Create a Package...', command: 'application:create-package' } - { label: 'Install a Package Manually...', command: 'application:install-package' } + { label: 'Create a Plugin...', command: 'application:create-package' } + { label: 'Install a Plugin Manually...', command: 'application:install-package' } { type: 'separator' } - { label: 'Run Package &Specs...', command: 'application:run-package-specs' } + { label: 'Run Plugin &Specs...', command: 'application:run-package-specs' } { label: 'Run &N1 Specs', command: 'application:run-all-specs' } { type: 'separator' } { label: 'Open Detailed Logs', command: 'window:open-errorreporter-logs' }