Commit Graph

31 Commits

Author SHA1 Message Date
Andreas Hocevar
04a33220a8 Parse olx.js and convert types into typedef properties 2014-04-08 11:41:24 -06:00
Paul Spencer
6d3bbe61ce Upgrade to jsdoc 3.3. 2014-04-08 07:39:57 -04:00
ahocevar
d4eb5dd2ee Use a more visually appealing margin for descriptions 2014-03-27 13:00:08 +01:00
ahocevar
a5d8f463ff Clean up
Only mark symbol as unexported when it is not in the API, and
no longer extract links from fires annotations because all links
are handled now.
2014-03-27 12:37:01 +01:00
ahocevar
15b0bc719e Do not loop through parents
Now that we use the parseComplete event, we walk through all
doclets in the loop anyway.
2014-03-27 01:56:31 +01:00
ahocevar
a1d9491d62 Do not delete event and fires doclets 2014-03-27 01:18:59 +01:00
ahocevar
cc1fceab05 Do not query the array twice 2014-03-26 23:46:42 +01:00
ahocevar
e5edb5c0e3 Also consider linked symbols as documented 2014-03-26 18:33:15 +01:00
ahocevar
f129a68248 Only add symbols to the unexported array once
This basically fixes a typo that caused unexported symbols to
be added to the unexported array multiple times.
2014-03-26 18:32:36 +01:00
ahocevar
118d9c200a Remove undocumented symbols at the end of the parsing process
This ensures that we do not mark symbols as undocumented before
all potential dependencies are parsed.
2014-03-26 18:31:31 +01:00
ahocevar
a3b5376520 Add missing event documentation and stability tags 2014-03-26 14:04:58 +01:00
ahocevar
4fad17b213 Make clearer what the 'Event' for observable properties means 2014-03-25 18:24:37 +01:00
ahocevar
7a9353cc87 Document classes and properties from externs/oli.js 2014-03-25 18:24:09 +01:00
ahocevar
d0ac615bef Distinct unexported and undocumented symbols 2014-03-25 18:23:05 +01:00
ahocevar
026c7149c8 Fix @override documentation 2014-03-25 18:21:55 +01:00
ahocevar
7e850ca33d Use JSDoc's stock event documentation 2014-03-25 18:21:08 +01:00
ahocevar
50f8eb65fd Add capabilities to document events 2014-03-24 21:53:18 +01:00
Marc Jansen
32524d186a Add explicit includes/excludes to jsdoc config. 2014-03-06 16:06:51 +01:00
Bart van den Eijnden
304e7c7df7 Add properties found in objectliterals.jsdoc to the API 2014-02-11 14:49:04 +01:00
Éric Lemoine
7fa3a38081 external/src/types.js file no longer exists 2013-12-12 16:57:39 +01:00
Frederic Junod
32c2b5311e Move apidoc CSS style out of layout.css 2013-11-21 10:51:59 +01:00
Frederic Junod
fd0a157a39 Remove '(Optional)' from Description 2013-11-14 10:21:23 +01:00
Frederic Junod
b54547a4e1 Fix 'change' event name in apidoc 2013-11-08 08:06:11 +01:00
Paul Spencer
d18119d98b Remove unnecessary Get column from observables 2013-10-28 16:12:08 -04:00
Paul Spencer
e858727bd0 Fix @todo observable name reference. 2013-10-28 16:11:40 -04:00
Paul Spencer
d3b8d0b676 Add jsdoc plugin that maps @todo tags to @stability and @observable tags.
This is a temporary measure until Plovr handles custom tags or is replaced in the build system.

Add support for indicating API stability with inline documentation

In preparation for documenting the stability of API features, this commit adds support for indicating API stability via a new jsdoc tag @stability.  There is a small plugin for jsdoc that adds a new tag, @stabiility, with some ability to enforce specific level names.  The templates and css have been updated to include the stability level in the generated documentation. (+1 squashed commit)
Squashed commits:
[d6bc03d] Add jsdoc plugin for documenting observable properties of a class.
2013-10-28 15:17:59 -04:00
Jonas Mueller
3c902af042 Typo retieving -> retrieving 2013-10-14 22:50:19 +02:00
Jonas Mueller
843c9cab83 Typo describes -> describe 2013-10-14 22:48:17 +02:00
Tim Schaub
c4dba8e828 Link to website root 2013-09-24 15:14:49 +02:00
ahocevar
b80022036f ol3 logo for examples and apidoc header 2013-09-24 14:42:04 +02:00
Tim Schaub
4def0c6a84 Differentiating doc from apidoc
This renames the doc task to apidoc.  The apidoc delegates to jsdoc3 currently.  We will have additional documentation that is not built by jsdoc3.  It makes sense to reserve the more general 'doc' name for building all documentation (not just apidoc).
2013-09-23 23:58:25 +02:00