diff --git a/src/scroll-view.coffee b/src/scroll-view.coffee
index c6d470579..86743be4c 100644
--- a/src/scroll-view.coffee
+++ b/src/scroll-view.coffee
@@ -1,6 +1,6 @@
 {View} = require './space-pen-extensions'
 
-# Extended: Represents a view that scrolls.
+# Deprecated: Represents a view that scrolls.
 #
 # Handles several core events to update scroll position:
 #
diff --git a/src/select-list-view.coffee b/src/select-list-view.coffee
index dc494cb00..046be1a3d 100644
--- a/src/select-list-view.coffee
+++ b/src/select-list-view.coffee
@@ -2,7 +2,7 @@
 TextEditorView = require './text-editor-view'
 fuzzyFilter = require('fuzzaldrin').filter
 
-# Essential: Provides a view that renders a list of items with an editor that
+# Deprecated: Provides a view that renders a list of items with an editor that
 # filters the items. Used by many packages such as the fuzzy-finder,
 # command-palette, symbols-view and autocomplete.
 #
diff --git a/src/text-editor-view.coffee b/src/text-editor-view.coffee
index e3dbcfe2c..f27b88e76 100644
--- a/src/text-editor-view.coffee
+++ b/src/text-editor-view.coffee
@@ -7,7 +7,7 @@ TextEditorElement = require './text-editor-element'
 TextEditorComponent = require './text-editor-component'
 {deprecate} = require 'grim'
 
-# Public: Represents the entire visual pane in Atom.
+# Deprecated: Represents the entire visual pane in Atom.
 #
 # The TextEditorView manages the {TextEditor}, which manages the file buffers.
 # `TextEditorView` is intentionally sparse. Most of the things you'll want
diff --git a/src/workspace-view.coffee b/src/workspace-view.coffee
index 06a39e9a5..b293befc9 100644
--- a/src/workspace-view.coffee
+++ b/src/workspace-view.coffee
@@ -12,7 +12,7 @@ PaneView = require './pane-view'
 PaneContainerView = require './pane-container-view'
 TextEditor = require './text-editor'
 
-# Extended: The top-level view for the entire window. An instance of this class is
+# Deprecated: The top-level view for the entire window. An instance of this class is
 # available via the `atom.workspaceView` global.
 #
 # It is backed by a model object, an instance of {Workspace}, which is available