Commit Graph

6 Commits

Author SHA1 Message Date
Joey Parrish 43e086dbaf Update the debugging tutorial for clarity
This updates the debugging tutorial to clarify a few things:
 - Formatting in the sample console output is not exact
 - Log level should be set in the top of initApp() before we construct
   the Player object
 - Verbose messages are only seen after we change the log level and
   reload

Closes #653

Change-Id: Id0d7dabff225c3d82a9c54c05bb356a0bfa9b241
2017-01-20 10:28:34 -08:00
Joey Parrish 3aea360b30 Partial revert of 43958d43
In the tutorial, I mentioned clicking the error.  That is a feature of
the demo app and does not apply in context.

This reverts the tutorial part of Change-Id
I988a40c882adf7c3c9da856e7c850649efecadcf

Change-Id: I782a5ebc2fc7bf744e2cb67890aae28a7817029a
2016-11-15 08:21:47 -08:00
Joey Parrish 43958d434c Link to error docs from the demo app
When an error is shown by the demo app, that error is now a link to
the docs for that specific error code.

Also updates the debugging tutorial to mention that this is clickable.

Closes #553

Change-Id: I988a40c882adf7c3c9da856e7c850649efecadcf
2016-11-14 23:57:57 +00:00
Joey Parrish 2567d07576 Rewrite the debugging tutorial
This should be less awkward and artificial, and focuses more on the
debugging tools available than trying to solve a fictional problem.

Change-Id: Idc451115b777cea3ba84f68d489fe817f8bf0350
2016-09-26 11:06:19 -07:00
Joey Parrish 04d3df3ae8 Apply feedback from doc review
- Add prereqs section
  - Add architecture diagrams
  - Adjust doc margins
  - Change some wording and fix typos
  - Convert alert() to console.error() in basic usage tutorial
  - Expand prose in debugging tutorial
  - Add comments about asynchronous methods
  - Expand description of Closure base
  - Change some links to source rather than API docs
  - Clarify some vague language
  - Refactor some of the plugin text

Modified jsdoc to add a new 'linksource' tag to link directly to the
source code for an entity.

Change-Id: I6b879050fc59917ce98954a4fabd8afca60af456
2016-04-13 17:12:32 -07:00
Joey Parrish c8e80cb58d Tutorials and other doc revisions
- Update tutorial link in README
 - Fix python version in README
 - Move jsdoc conf to docs/ folder
 - Add API docs main page
 - Change style of inline code blocks
 - Don't repeat tutorial title in jsdoc template
   - (makes it easier to read tutorials on github as MD)
 - Add tutorials for:
   - Welcome to Shaka
   - Basic Usage
   - Debugging
   - Configuration
   - Networking and Buffering Configuration
   - DRM Configuration
   - License Server Authentication
   - Plugins
 - Tutorials still to come:
   - License Headers and Track Restrictions
   - Special Considerations for Live
   - v2 Upgrade Guide

Change-Id: I16401c216cf4023d9097750ac7f6090c68bf3c9b
2016-04-06 19:17:51 +00:00