600402d440
All the docs related files (docs-app, doc-gen, content, etc)
are now to be found inside the `/aio` folder.
The related gulp tasks have been moved from the top level
gulp file to a new one inside the `/aio` folder.
The structure of the `/aio` folder now looks like:
```
/aio/
build/ # gulp tasks
content/ #MARKDOWN FILES for devguides, cheatsheet, etc
devguides/
cheatsheets/
transforms/ #dgeni packages, templates, etc
src/
app/
assets/
content/ #HTML + JSON build artifacts produced by dgeni from /aio/content.
#This dir is .gitignored-ed
e2e/ #protractor tests for the doc viewer app
node_modules/ #dependencies for both the doc viewer builds and the dgeni stuff
#This dir is .gitignored-ed
gulpfile.js #Tasks for generating docs and building & deploying the doc viewer
```
Closes #14361
38 lines
1.2 KiB
JavaScript
38 lines
1.2 KiB
JavaScript
module.exports = function addNotYetDocumentedProperty(EXPORT_DOC_TYPES, log, createDocMessage) {
|
|
return {
|
|
$runAfter: ['tags-parsed'],
|
|
$runBefore: ['rendering-docs'],
|
|
$process: function(docs) {
|
|
docs.forEach(function(doc) {
|
|
|
|
if (EXPORT_DOC_TYPES.indexOf(doc.docType) === -1) return;
|
|
|
|
// NotYetDocumented means that no top level comments and no member level comments
|
|
doc.notYetDocumented = notYetDocumented(doc);
|
|
|
|
if (doc.constructorDoc) {
|
|
doc.constructorDoc.notYetDocumented = notYetDocumented(doc.constructorDoc);
|
|
doc.notYetDocumented = doc.notYetDocumented && doc.constructorDoc.notYetDocumented;
|
|
}
|
|
|
|
if (doc.members) {
|
|
doc.members.forEach(function(member) {
|
|
member.notYetDocumented = notYetDocumented(member);
|
|
doc.notYetDocumented = doc.notYetDocumented && member.notYetDocumented;
|
|
});
|
|
}
|
|
|
|
if (doc.notYetDocumented) {
|
|
log.debug(createDocMessage('Not yet documented', doc));
|
|
}
|
|
});
|
|
|
|
return docs;
|
|
}
|
|
};
|
|
};
|
|
|
|
function notYetDocumented(doc) {
|
|
return !doc.noDescription && doc.description.trim().length == 0;
|
|
}
|