== Why is this an issue?

A properly formatted (book)mark comment adds an entry in Xcode's quick jump bar. But if the formatting is incorrect, then it's just a comment. A ``++MARK++`` comment must be formatted in one of the following ways


* ``++// MARK: text++`` - Adds text to quick jump bar
* ``++// MARK: - ++`` - Adds hr to quick jump bar
* ``++// MARK: - text++`` - Adds HR, followed by text to quick jump bar
* ``++// BOOKMARK++``
* ``++// BOOKMARKS++``
* ``++//BOOKMARK++``


=== Noncompliant code example

[source,swift]
----
//MARK: -  // Noncompliant; leading space missing
//&nbsp;&nbsp;MARK: - // Noncompliant; too many leading spaces
// MARK -  // Noncompliant; missing colon
// MARK:  // Noncompliant; must contain text or dash
// MARK:&nbsp;&nbsp;foo  // Noncompliant; too many spaces after colon
----


=== Compliant solution

[source,swift]
----
// MARK: -
// MARK: foo
----



ifdef::env-github,rspecator-view[]
'''
== Comments And Links
(visible only on this page)

=== on 5 Sep 2017, 15:32:10 Elena Vilchik wrote:
In fact this rule is a pure formatting rule, whatever the way you put spaces in "MARK" comment, it will work properly.

endif::env-github,rspecator-view[]
