Skip to content
This repository has been archived by the owner on Jul 13, 2023. It is now read-only.

docs: Update docs #849

Merged
merged 1 commit into from
Mar 24, 2017
Merged

docs: Update docs #849

merged 1 commit into from
Mar 24, 2017

Conversation

jrconlin
Copy link
Member

Fixes typos, spilling, and other minor errors.

@codecov-io
Copy link

codecov-io commented Mar 21, 2017

Codecov Report

Merging #849 into master will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@          Coverage Diff          @@
##           master   #849   +/-   ##
=====================================
  Coverage     100%   100%           
=====================================
  Files          48     51    +3     
  Lines        9470   9504   +34     
=====================================
+ Hits         9470   9504   +34
Impacted Files Coverage Δ
autopush/settings.py 100% <ø> (ø) ⬆️
autopush/router/apnsrouter.py 100% <ø> (ø) ⬆️
autopush/router/apns2.py 100% <ø> (ø) ⬆️
autopush/web/base.py 100% <0%> (ø) ⬆️
autopush/router/__init__.py 100% <0%> (ø)
autopush/web/__init__.py 100% <0%> (ø)
autopush/tests/__init__.py 100% <0%> (ø)

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b0409be...9520e50. Read the comment docs.

docs/apns.rst Outdated
"aps": {
"alert": "notification title",
"content_available": 1
}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Need a comma here.

.. code-block:: json

{
"aps": {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why aps instead of apns?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because Apple. aps is a reserved name for the dictionary of meta values.

docs/index.rst Outdated
@@ -22,7 +22,7 @@ the `Mozilla Push Service architecture diagram`_. This push service uses
websockets to talk to Firefox, with a Push endpoint that implements the
:term:`WebPush` standard for its :ref:`http` API.

Autopush API's
Autopush APIs
==============
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Length usually needs to match the text above.

@@ -135,7 +135,7 @@ Reference
License
=======

``autopush`` is offered under the Apache License 2.0.
``autopush`` is offered under the Mozilla Public License 2.0.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well that's weird, wonder why that was there.

Copy link
Member

@pjenvey pjenvey left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just a few things I found after looking at sphinx rendering

docs/apns.rst Outdated
*aps* is reserved as a sub-dictionary. All other *key*: *value* slots are open.

In addition, you must specify the following headers:
* *apns-id*: A lowercase, dash formatted UUID for this message.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missed an extra newline here to make this section render nicely

docs/apns.rst Outdated
* *apns-id*: A lowercase, dash formatted UUID for this message.
* *apns-priority*: Either **10** for Immediate delivery or **5** for delayable delivery.
* *apns-topic*: The bundle ID for the recipient application. This must match the bundle ID of
the AppID used to create the *"Apple Push Services:..."* certificate. It usually has the format
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a few of these hanging lines need indents to render nicely too

docs/apns.rst Outdated
-----------------------

APNS returns a status code and an optional JSON block describing the error. A list of `these
responses are provided in the APNS documentation <https://developer.apple.com/library/content/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/APNsProviderAPI.html#//apple_ref/doc/uid/TP40008194-CH101-SW18>`_
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this link seems dead

Fixes typos, spilling, and other minor errors.
@bbangert bbangert merged commit 235bd1e into master Mar 24, 2017
@bbangert bbangert deleted the docs branch March 24, 2017 15:57
@jrconlin jrconlin mentioned this pull request Mar 28, 2017
@jrconlin jrconlin restored the docs branch June 8, 2017 22:14
@jrconlin jrconlin deleted the docs branch June 8, 2017 22:29
@jrconlin jrconlin restored the docs branch June 8, 2017 22:29
@jrconlin jrconlin deleted the docs branch June 8, 2017 22:30
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants