Shorthand FAQ
Using Shorthand for Storytelling
![Bright blue background with a yellow typewriter](./assets/9Jwr6Ydkc5/adobestock_367502882-4096x1570.jpeg)
Embedding Content into Other Platforms
Once published, you can embed your Shorthand story into anything that accepts full HTML code.
- Click Republish
- Click Copy Embed Code
- Paste the code into the desired document
![Screenshot of "Embed this story into your site" option](./assets/37auPkTQLw/screen-shot-2022-02-03-at-11-07-12-am-841x439.png)
Embedding Content into Your Shorthand Story
Copy a link from the other platform and paste into the Rich Media option in Shorthand.
![Screenshot of Insert Rich Embed Option](./assets/KX1qXXSouZ/screen-shot-2022-02-03-at-11-03-25-am-384x92.png)
Or, copy code from the other platform and in Shorthand click Add Section, Custom HTML. Paste the code into the resulting block, and click Preview to view the results.
![Custom HTML Option under "Add Section"](./assets/4ZIpwtpNA6/screen-shot-2022-02-03-at-10-17-05-am-717x433.png)
A few ideas for embedding content into your Shorthand Stories
- Tableau Public: For visualizing maps and data
- Padlet: For interactive boards
- SoundCloud: For adding audio to your story
- InfoGram: For infographics
- Youtube/Vimeo videos
- Many more!
![blue background with white headphones](./assets/OB58u9NN2y/adobestock_217923780-4096x2297.jpeg)
Notes About Alt Text
Here are a few resources that were recommended to me about alt text. The gist:
- Consider putting the keyword phrase near the beginning of the description, then move into a description.
- Be specific and succinct. Aim for 10-15 words at most.
- Describe information, not aesthetics
- When images include text, simply write the text as the alt text.
How to Write Great Alt Text Descriptions
My personal pet peeve is: Imagine you have to listen to someone read you literally everything that is on the webpage, including 'link,' 'visited link,' 'combo box,' 'navigation bar,' etc. You find yourself wanting to scream 'Read me just the facts!'
Lighthouse Accessibility Check
In a Chrome Browser:
Click the more options option in the far right
Click "More Tools," "Developer Tools"
![Screenshot choosing more options (three dots), More Tools, Developer Tools](./assets/veqcga3Wko/screen-shot-2022-02-08-at-7-19-51-pm-803x559.png)
Select "Lighthouse"
Select "Accessibility" and "Generate Report"
![Screenshot of clicking an arrow for more options, then the Lighthouse option](./assets/VeRFuk9eC5/screen-shot-2022-02-08-at-7-21-44-pm-570x206.png)
![Screenshot of selecting Accessibility option, then clicking Generate Report](./assets/krP8crojj9/screen-shot-2022-02-08-at-7-23-42-pm-556x410.png)
Lighthouse will generate a score and display any accessibility issues.
Running Lighthouse in Incognito mode may get the best results.
![Lighthouse accessibility score: 98](./assets/1RyvwJLAa3/screen-shot-2022-02-08-at-7-25-32-pm-551x390.png)
Shorthand Themes
Themes offer some preset design options for your header and sections.
The themes available in our plan are Shorthand Basic, Shorthand Blue, and a custom-branded SIGnetwork theme. Click the Themes icon to change the theme of your story.
![Themes column with SIGnetwork, Shorthand Basic, and Shorthand Blue options](./assets/NLBsw7WmVi/screen-shot-2022-02-03-at-11-00-43-am-510x586.png)
Shorthand Examples
- Start Network: An Annual Report
- School Leaders on the Frontline: Individual Stories
- 407 and Rising: Sharing Data
Embedding External Sources:
- The Story of AI in Patents: Uses simple buttons and links for a lengthier description/report of briefly discussed topics
- Brexit by Numbers: Embedded graphs, maps, and infographics
- Hipsters, Gin, and the Basket of Goods: Embedded charts and timeline
Resources
![Yellow background with a movie clapperboard that says "Storytelling"](./assets/RPBY0WwGXN/adobestock_257048440-4096x2731.jpeg)