@@ -55,8 +55,8 @@ public let NSNotFound: Int = .max
55
55
/// - If `value` is the empty string, `key` is returned.
56
56
/// - If `value` is not the empty string, `value` is returned.
57
57
///
58
- /// Exporting Localizations
59
- /// -----------------------
58
+ /// Export Localizations with Xcode
59
+ /// -------------------------------
60
60
///
61
61
/// Xcode can read through a project's code to find invocations of
62
62
/// `NSLocalizedString(_:tableName:bundle:value:comment:)` and automatically
@@ -80,8 +80,8 @@ public let NSNotFound: Int = .max
80
80
/// xcodebuild -importLocalizations -project <projectname>.xcodeproj \
81
81
/// -localizationPath <path>
82
82
///
83
- /// Keys and Values
84
- /// ---------------
83
+ /// Choose Meaningful Keys
84
+ /// ----------------------
85
85
///
86
86
/// Words can often have multiple different meanings depending on the context
87
87
/// in which they're used. For example, the word "Book" can be used as a noun—a
@@ -104,8 +104,8 @@ public let NSNotFound: Int = .max
104
104
/// verb: Title of the button that makes a reservation.
105
105
/// """)
106
106
///
107
- /// Limitations
108
- /// -----------
107
+ /// Use Only String Literals
108
+ /// ------------------------
109
109
///
110
110
/// Variables and interpolated strings cannot be passed into `key`, `tableName`,
111
111
/// `value`, and `comment`.
@@ -152,8 +152,8 @@ public let NSNotFound: Int = .max
152
152
/// Luckily, since comments aren't localized, multi-line string literals can be
153
153
/// safely used with `comment`.
154
154
///
155
- /// Alternatives
156
- /// ------------
155
+ /// Restrict Autosynthesized Localizations
156
+ /// --------------------------------------
157
157
///
158
158
/// If having Xcode generate strings files from code isn't desired behavior,
159
159
/// you should call `Bundle.localizedString(forKey:value:table:)` instead.
0 commit comments