docs: remove/update bad links; adjust formatting (#17)

Author: space-pope

content/docs/Android/getting-started.md

@@ -134,7 +134,7 @@ We've listed all possible speech events here; see [the documentation](https://ww
 
 If the event is `RECOGNIZE`, `context.transcript` will give you the raw text of what the user just said. Translating that raw text into an action in your app is the job of an NLU, or natural language understanding, component. Spokestack currently leaves the choice of NLU up to the app: There's a variety of NLU services out there ([DialogFlow](https://dialogflow.com/), [LUIS](https://www.luis.ai/home), or [wit.ai](https://wit.ai/), to name a few), or, if your app is simple enough, you can make your own with string matching or regular expressions.
 
-We know that NLU is an important piece of the puzzle, and we're working on a full-featured NLU component for Spokestack based on years of research and lessons learned from working with the other services; [sign up for our newsletter](LINK) to be the first to know when it's ready.
+We know that NLU is an important piece of the puzzle, and we're working on a full-featured NLU component for Spokestack based on years of research and lessons learned from working with the other services; we'll update this space when it's ready.
 
 For the sake of our demo, though, let's say you're creating a voice-controlled timer. `handleSpeech` might look something like this:
 
@@ -202,7 +202,7 @@ class MyActivity : AppCompatActivity(), OnSpeechEventListener, TTSCallback {
 }
 ```
 
-The API key in this example sets you up to use the demo voice available for free with Spokestack; for more configuration options and details about controlling pronunciation, see [the TTS guide](tts).
+The API key in this example sets you up to use the demo voice available for free with Spokestack; for more configuration options and details about controlling pronunciation, see [the TTS guide](/docs/Concepts/tts).
 
 ## Conclusion
 

content/docs/Concepts/tts.md

@@ -23,10 +23,12 @@ Note that long inputs should be split into separate `s` ("sentence") elements fo
 Currently, Spokestack is focused on pronunciation of English words and loan words/foreign words common in spoken English and thus restricts its character set from the full range of [IPA](https://en.wikipedia.org/wiki/International_Phonetic_Alphabet) characters. Characters valid for an IPA `ph` attribute are:
 
 ```bash
- [' ', ',', 'a', 'b', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
-  'n', 'o', 'p', 'r', 's', 't', 'u', 'v', 'w', 'z', 'æ', 'ð', 'ŋ', 'ɑ',
-  'ɔ', 'ə', 'ɛ', 'ɝ', 'ɪ', 'ʃ', 'ʊ', 'ʌ', 'ʒ', 'ˈ', 'ˌ', 'ː', 'θ', 'ɡ',
-  'x', 'y', 'ɹ', 'ʰ', 'ɜ', 'ɒ', 'ɚ', 'ɱ', 'ʔ', 'ɨ', 'ɾ', 'ɐ', 'ʁ', 'ɵ', 'χ']
+ [' ', ',', 'a', 'b', 'd', 'e', 'f', 'g', 'h', 'i', 'j',
+ 'k', 'l', 'm', 'n', 'o', 'p', 'r', 's', 't', 'u', 'v',
+ 'w', 'z', 'æ', 'ð', 'ŋ', 'ɑ', 'ɔ', 'ə', 'ɛ', 'ɝ', 'ɪ',
+ 'ʃ', 'ʊ', 'ʌ', 'ʒ', 'ˈ', 'ˌ', 'ː', 'θ', 'ɡ', 'x', 'y',
+ 'ɹ', 'ʰ', 'ɜ', 'ɒ', 'ɚ', 'ɱ', 'ʔ', 'ɨ', 'ɾ', 'ɐ', 'ʁ',
+ 'ɵ', 'χ']
 ```
 
 and the emphasis symbols `ˈ`, `,`, `ˌ`, and `ː`.
@@ -35,11 +37,14 @@ Using invalid characters will not cause an error, but it might result in unexpec
 
 ### Some brief examples
 
-- when you just can't give up that web prefix:
+- When you just can't give up that web prefix:
+
   `<speak>See all our products at <say-as interpret-as="characters">www</say-as> dot my company dot com</speak>`
 
-- insert a pregnant pause:
+- Insert a pregnant pause:
+
   `<speak>Today's stock price <break time="500ms"/> fell three percent.</speak>`
 
-- customize pronunciation to make a point:
+- Customize pronunciation to make a point:
+
   `<speak>I don't care what you say; it's pronounced <phoneme alphabet="ipa" ph="gɪf">gif</phoneme>, not <phoneme alphabet="ipa" ph="dʒɪf">gif</phoneme>!</speak>`

content/docs/iOS/getting-started.md

@@ -113,7 +113,7 @@ All we're doing here is reflecting system events back to the main pipeline. See
 
 Inside `didRecognize`, `result.transcript` will give you the raw text of what the user just said. Translating that raw text into an action in your app is the job of an NLU, or natural language understanding, component. Spokestack currently leaves the choice of NLU up to the app: There's a variety of NLU services out there ([DialogFlow](https://dialogflow.com/), [LUIS](https://www.luis.ai/home), or [wit.ai](https://wit.ai/), to name a few), or, if your app is simple enough, you can make your own with string matching or regular expressions.
 
-We know that NLU is an important piece of the puzzle, and we're working on a full-featured NLU component for Spokestack based on years of research and lessons learned from working with the other services; [sign up for our newsletter](LINK) to be the first to know when it's ready.
+We know that NLU is an important piece of the puzzle, and we're working on a full-featured NLU component for Spokestack based on years of research and lessons learned from working with the other services; we'll update this space when it's ready.
 
 For the sake of our demo, though, let's say you're creating a voice-controlled timer. `didRecognize` might look something like this: