diff --git a/AsyncDisplayKit/ASCellNode.h b/AsyncDisplayKit/ASCellNode.h
index 6e11c8593b..e38376bee4 100644
--- a/AsyncDisplayKit/ASCellNode.h
+++ b/AsyncDisplayKit/ASCellNode.h
@@ -66,12 +66,12 @@ typedef NS_ENUM(NSUInteger, ASCellNodeVisibilityEvent) {
 //@property (atomic, retain) UIColor *backgroundColor;
 @property (nonatomic) UITableViewCellSelectionStyle selectionStyle;
 
-/*
+/**
  * A Boolean value that indicates whether the node is selected.
  */
 @property (nonatomic, assign) BOOL selected;
 
-/*
+/**
  * A Boolean value that indicates whether the node is highlighted.
  */
 @property (nonatomic, assign) BOOL highlighted;
diff --git a/AsyncDisplayKit/ASEditableTextNode.h b/AsyncDisplayKit/ASEditableTextNode.h
index 5a7ea07940..31e39aa60e 100644
--- a/AsyncDisplayKit/ASEditableTextNode.h
+++ b/AsyncDisplayKit/ASEditableTextNode.h
@@ -18,7 +18,7 @@ NS_ASSUME_NONNULL_BEGIN
  */
 @interface ASEditableTextNode : ASDisplayNode
 
-// @abstract The text node's delegate, which must conform to the <ASEditableTextNodeDelegate> protocol.
+//! @abstract The text node's delegate, which must conform to the <ASEditableTextNodeDelegate> protocol.
 @property (nonatomic, readwrite, weak) id <ASEditableTextNodeDelegate> delegate;
 
 #pragma mark - Configuration
@@ -66,12 +66,12 @@ NS_ASSUME_NONNULL_BEGIN
 //! @abstract The text input mode used by the receiver's keyboard, if it is visible. This value is undefined if the receiver is not the first responder.
 @property (nonatomic, readonly) UITextInputMode *textInputMode;
 
-/*
+/**
  @abstract The textContainerInset of both the placeholder and typed textView. This value defaults to UIEdgeInsetsZero.
  */
 @property (nonatomic, readwrite) UIEdgeInsets textContainerInset;
 
-/*
+/**
  @abstract The returnKeyType of the keyboard. This value defaults to UIReturnKeyDefault.
  */
 @property (nonatomic, readwrite) UIReturnKeyType returnKeyType;
diff --git a/AsyncDisplayKit/Details/ASDataController+Subclasses.h b/AsyncDisplayKit/Details/ASDataController+Subclasses.h
index cb67a203ef..51b7548f50 100644
--- a/AsyncDisplayKit/Details/ASDataController+Subclasses.h
+++ b/AsyncDisplayKit/Details/ASDataController+Subclasses.h
@@ -38,7 +38,7 @@ typedef void (^ASDataControllerCompletionBlock)(NSArray<ASCellNode *> *nodes, NS
  */
 - (void)batchLayoutNodesFromContexts:(NSArray<ASIndexedNodeContext *> *)contexts ofKind:(NSString *)kind completion:(ASDataControllerCompletionBlock)completionBlock;
 
-/*
+/**
  * Perform measurement and layout of loaded nodes on the main thread, skipping unloaded nodes.
  *
  * @discussion Once nodes have loaded their views, we can't layout in the background so this is a chance
diff --git a/AsyncDisplayKit/TextKit/ASTextKitRenderer.h b/AsyncDisplayKit/TextKit/ASTextKitRenderer.h
index 1889131f52..e57c5dc174 100755
--- a/AsyncDisplayKit/TextKit/ASTextKitRenderer.h
+++ b/AsyncDisplayKit/TextKit/ASTextKitRenderer.h
@@ -58,7 +58,7 @@
 @property (nonatomic, assign, readonly) CGFloat currentScaleFactor;
 
 #pragma mark - Drawing
-/*
+/**
  Draw the renderer's text content into the bounds provided.
 
  @param bounds The rect in which to draw the contents of the renderer.
@@ -67,20 +67,20 @@
 
 #pragma mark - Layout
 
-/*
+/**
  Returns the computed size of the renderer given the constrained size and other parameters in the initializer.
  */
 - (CGSize)size;
 
 #pragma mark - Text Ranges
 
-/*
+/**
  The character range from the original attributedString that is displayed by the renderer given the parameters in the
  initializer.
  */
 - (std::vector<NSRange>)visibleRanges;
 
-/*
+/**
  The number of lines shown in the string.
  */
 - (NSUInteger)lineCount;