diff --git a/docs/index.md b/docs/index.md
index eaaf9013..a76545aa 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -767,7 +767,7 @@ When using rippled APIs, [specify XRP amounts in drops](https://ripple.com/build
 
 ## Listening to streams
 
-The `rippled` server can push updates to your client when various events happen. Refer to [Subscriptions in the `rippled` API docs](https://ripple.com/build/rippled-apis/#subscriptions) for details.
+The `rippled` server can push updates to your client when various events happen. Refer to [Subscriptions in the `rippled` API docs](https://developers.ripple.com/subscription-methods.html) for details.
 
 Note that the `streams` parameter for generic streams takes an array. For example, to subscribe to the `validations` stream, use `{ streams: [ 'validations' ] }`.
 
diff --git a/docs/src/rippledAPIs.md.ejs b/docs/src/rippledAPIs.md.ejs
index dde92ef4..223b7432 100644
--- a/docs/src/rippledAPIs.md.ejs
+++ b/docs/src/rippledAPIs.md.ejs
@@ -9,7 +9,7 @@ When using rippled APIs, [specify XRP amounts in drops](https://ripple.com/build
 
 ## Listening to streams
 
-The `rippled` server can push updates to your client when various events happen. Refer to [Subscriptions in the `rippled` API docs](https://ripple.com/build/rippled-apis/#subscriptions) for details.
+The `rippled` server can push updates to your client when various events happen. Refer to [Subscriptions in the `rippled` API docs](https://developers.ripple.com/subscription-methods.html) for details.
 
 Note that the `streams` parameter for generic streams takes an array. For example, to subscribe to the `validations` stream, use `{ streams: [ 'validations' ] }`.
 
diff --git a/src/ledger/parse/payment.ts b/src/ledger/parse/payment.ts
index a9b22d02..b6b2764e 100644
--- a/src/ledger/parse/payment.ts
+++ b/src/ledger/parse/payment.ts
@@ -17,6 +17,7 @@ function removeGenericCounterparty(amount, address) {
     _.omit(amount, 'counterparty') : amount
 }
 
+// Payment specification
 function parsePayment(tx: any): Object {
   assert(tx.TransactionType === 'Payment')