Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit e30d31c4 authored by Scott Main's avatar Scott Main
Browse files

docs: misc bugs from external tracker

Change-Id: I928659b23d1ff3a5d017d4fb50acb8ac0e3b251b
parent 8f70a7c4
Loading
Loading
Loading
Loading
+7 −2
Original line number Diff line number Diff line
@@ -153,8 +153,13 @@ notifications of a particular kind are pending.</p>
<p>To create an app that feels streamlined, pleasant, and respectful, it is important to design your notifications carefully. Notifications embody your app's voice, and contribute to your app's personality. Unwanted or unimportant notifications can annoy the user, so use them judiciously.</p>

<h4>When to display a notification</h4>
<p>To create an application that people love, it's important to recognize that the user's attention and focus is a resource that must be protected. While Android's notification system has been designed to minimize the impact of notifications on the users attention, it is nonetheless still important to be aware of the fact that notifications are potentially interrupting the users task flow. As you plan your notifications, ask yourself if they are important enough to warrant an interruption. If you are unsure, allow the user to opt into a notification using your apps notification settings or adjust the notifications priority flag.</p>
<p>Time sensitive events are great opportunities for valuable notifications with high priority, especially if these synchronous events involve other people. For instance, an incoming chat is a real time and synchronous form of communication: there is another user actively waiting on you to respond. Calendar events are another good example of when to use a notification and grab the user's attention, because the event is imminent, and calendar events often involve other people.</p>
<p>To create an application that people love, it's important to recognize that the user's attention and
focus is a resource that must be protected. While Android's notification system has been designed
to minimize the impact of notifications on the users attention, it is nonetheless still important
to be aware of the fact that notifications are potentially interrupting the users task flow. As you
plan your notifications, ask yourself if they are important enough to warrant an interruption. If
you are unsure, allow the user to opt into a notification using your apps notification settings or
adjust the notifications priority flag.</p>
<p>While well behaved apps generally only speak when spoken to, there are some limited cases where an
app actually should interrupt the user with an unprompted notification.</p>
<p>Notifications should be used primarily for <strong>time sensitive events</strong>, and especially if these
+3 −1
Original line number Diff line number Diff line
@@ -128,7 +128,9 @@ public void onDestroy() {
}
</pre>

<p>For a complete implementation of a service connection that binds to the {@code IInAppBillingService}, see the <a href="{@docRoot}/training/in-app-billing/preparing-iab-app.html#Connect">Selling In-app Products</a> training class.</p>
<p>For a complete implementation of a service connection that binds to the {@code IInAppBillingService},
see the <a href="{@docRoot}training/in-app-billing/preparing-iab-app.html">Selling In-app
Products</a> training class and associated sample.</p>

<h2 id="billing-requests">Making In-app Billing Requests</h2>
<p>Once your application is connected to Google Play, you can initiate purchase requests for in-app products. Google Play provides a checkout interface for users to enter their payment method, so your application does not need to handle payment transactions directly. When an item is purchased, Google Play recognizes that the user has ownership of that item and prevents the user from purchasing another item with the same product ID until it is consumed. You can control how the item is consumed in your application, and notify Google Play to make the item available for purchase again. You can also query Google Play to quickly retrieve the list of purchases that were made by the user. This is useful, for example, when you want to restore the user's purchases when your user launches your app.
+2 −2
Original line number Diff line number Diff line
@@ -708,9 +708,9 @@ device.</td>
  <td>Television</td>
  <td><code>android.hardware.type.television</code></td>
  <td>The application is designed for a television user experience.</td>
  <td>>This feature defines "television" to be a typical living room television experience: 
  <td>This feature defines "television" to be a typical living room television experience: 
  displayed on a big screen, where the user is sitting far away and the dominant form of 
  input is be something like a d-pad, and generally not through touch or a 
  input is something like a d-pad, and generally not through touch or a 
  mouse/pointer-device.</td>
</tr>

+1 −1
Original line number Diff line number Diff line
@@ -921,7 +921,7 @@ mNotifyManager.notify(0, mBuilder.build());
</p>
<pre>
 // Sets an activity indicator for an operation of indeterminate length
mBuilder.setProgress(0, 0, false);
mBuilder.setProgress(0, 0, true);
// Issues the notification
mNotifyManager.notify(0, mBuilder.build());
</pre>
+1 −1
Original line number Diff line number Diff line
@@ -314,7 +314,7 @@ to navigate backward:</p>
&#64;Override
public boolean {@link android.app.Activity#onKeyDown(int,KeyEvent) onKeyDown}(int keyCode, KeyEvent event) {
    // Check if the key event was the Back button and if there's history
    if ((keyCode == KeyEvent.KEYCODE_BACK) &amp;&amp; myWebView.{@link android.webkit.WebView#canGoBack() canGoBack}() {
    if ((keyCode == KeyEvent.KEYCODE_BACK) &amp;&amp; myWebView.{@link android.webkit.WebView#canGoBack() canGoBack}()) {
        myWebView.{@link android.webkit.WebView#goBack() goBack}();
        return true;
    }