From fc7f11d03b4380866033c38eb7649cdc5be93d9a Mon Sep 17 00:00:00 2001 From: Igor Minar Date: Thu, 18 Nov 2010 16:28:42 -0800 Subject: add @workInProgress tag and mark all @ngdocs as work in progress --- docs/collect.js | 3 +++ docs/directive.template | 8 ++++++++ docs/docs.css | 9 +++++++++ docs/filter.template | 8 ++++++++ docs/formatter.template | 8 ++++++++ docs/function.template | 8 ++++++++ docs/overview.template | 8 ++++++++ docs/service.template | 8 ++++++++ docs/spec/collectSpec.js | 12 ++++++++++++ docs/validator.template | 8 ++++++++ docs/widget.template | 8 ++++++++ 11 files changed, 88 insertions(+) (limited to 'docs') diff --git a/docs/collect.js b/docs/collect.js index 7fe326b4..17d5acb0 100644 --- a/docs/collect.js +++ b/docs/collect.js @@ -240,6 +240,9 @@ var TAG = { css: valueTag, see: valueTag, deprecated: valueTag, + workInProgress: function(doc, name, value) { + doc[name] = {description: markdown(value)}; + }, usageContent: valueTag, 'function': valueTag, description: markdownTag, diff --git a/docs/directive.template b/docs/directive.template index 9f1c9659..07e38ea7 100644 --- a/docs/directive.template +++ b/docs/directive.template @@ -1,5 +1,13 @@

{{name}}

+{{#workInProgress}} +
+ Work In Progress + This page is currently being revised. It might be incomplete or contain inaccuracies. + {{{workInProgress.description}}} +
+{{/workInProgress}} + {{#deprecated}}
Deprecated API diff --git a/docs/docs.css b/docs/docs.css index 75569e0f..4ade0405 100644 --- a/docs/docs.css +++ b/docs/docs.css @@ -159,3 +159,12 @@ a { font-weight: bold; color: red; } + +.workInProgress { + border: 2px solid orange; +} + +.workInProgress legend { + font-weight: bold; + color: orange; +} diff --git a/docs/filter.template b/docs/filter.template index b8e118a3..516957d0 100644 --- a/docs/filter.template +++ b/docs/filter.template @@ -1,5 +1,13 @@

{{name}}

+{{#workInProgress}} +
+ Work In Progress + This page is currently being revised. It might be incomplete or contain inaccuracies. + {{{workInProgress.description}}} +
+{{/workInProgress}} + {{#deprecated}}
Deprecated API diff --git a/docs/formatter.template b/docs/formatter.template index 0b437d9a..9ccdc811 100644 --- a/docs/formatter.template +++ b/docs/formatter.template @@ -1,5 +1,13 @@

{{name}}

+{{#workInProgress}} +
+ Work In Progress + This page is currently being revised. It might be incomplete or contain inaccuracies. + {{{workInProgress.description}}} +
+{{/workInProgress}} + {{#deprecated}}
Deprecated API diff --git a/docs/function.template b/docs/function.template index 46a6dc98..8765277b 100644 --- a/docs/function.template +++ b/docs/function.template @@ -1,5 +1,13 @@

{{name}}

+{{#workInProgress}} +
+ Work In Progress + This page is currently being revised. It might be incomplete or contain inaccuracies. + {{{workInProgress.description}}} +
+{{/workInProgress}} + {{#deprecated}}
Deprecated API diff --git a/docs/overview.template b/docs/overview.template index 5d3972d7..9902a16f 100644 --- a/docs/overview.template +++ b/docs/overview.template @@ -1,5 +1,13 @@

{{name}}

+{{#workInProgress}} +
+ Work In Progress + This page is currently being revised. It might be incomplete or contain inaccuracies. + {{{workInProgress.description}}} +
+{{/workInProgress}} + {{#deprecated}}
Deprecated API diff --git a/docs/service.template b/docs/service.template index 4328c21e..ee3a284e 100644 --- a/docs/service.template +++ b/docs/service.template @@ -1,5 +1,13 @@

{{name}}

+{{#workInProgress}} +
+ Work In Progress + This page is currently being revised. It might be incomplete or contain inaccuracies. + {{{workInProgress.description}}} +
+{{/workInProgress}} + {{#deprecated}}
Deprecated API diff --git a/docs/spec/collectSpec.js b/docs/spec/collectSpec.js index 2261b7a0..8002e0d6 100644 --- a/docs/spec/collectSpec.js +++ b/docs/spec/collectSpec.js @@ -230,6 +230,18 @@ describe('collect', function(){ }) }); + describe('@workInProgress', function() { + it('should parse @workInProgress without a description and default to true', function() { + TAG.workInProgress(doc, 'workInProgress', ''); + expect(doc.workInProgress).toEqual({description: ''}); + }); + + it('should parse @workInProgress with a description', function() { + TAG.workInProgress(doc, 'workInProgress', 'my description'); + expect(doc.workInProgress).toEqual({description: '

my description

'}); + }); + }); + }); describe('trim', function(){ diff --git a/docs/validator.template b/docs/validator.template index d0863f9f..64ab37b7 100644 --- a/docs/validator.template +++ b/docs/validator.template @@ -1,5 +1,13 @@

{{name}}

+{{#workInProgress}} +
+ Work In Progress + This page is currently being revised. It might be incomplete or contain inaccuracies. + {{{workInProgress.description}}} +
+{{/workInProgress}} + {{#deprecated}}
Deprecated API diff --git a/docs/widget.template b/docs/widget.template index b954f07c..418ad407 100644 --- a/docs/widget.template +++ b/docs/widget.template @@ -1,5 +1,13 @@

{{name}}

+{{#workInProgress}} +
+ Work In Progress + This page is currently being revised. It might be incomplete or contain inaccuracies. + {{{workInProgress.description}}} +
+{{/workInProgress}} + {{#deprecated}}
Deprecated API -- cgit v1.2.3