-
Notifications
You must be signed in to change notification settings - Fork 868
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add doc comments to docfx.json related config files. #8969
Conversation
Codecov ReportPatch coverage has no change and project coverage change:
Additional details and impacted files@@ Coverage Diff @@
## main #8969 +/- ##
==========================================
+ Coverage 76.88% 76.92% +0.03%
==========================================
Files 605 605
Lines 25074 25054 -20
==========================================
- Hits 19279 19272 -7
+ Misses 5795 5782 -13
☔ View full report in Codecov by Sentry. |
Co-authored-by: Yufei Huang <[email protected]>
…nto add-doc-comments
I've fixed commented issues with following commits.
It seems there are some unused code exists. |
Add commit (2a40b8c) |
* Add doc comments * Add warning suppression for obsolete * Add warning suppression for obsolete * Update src/Docfx.App/Config/BuildJsonConfig.cs Co-authored-by: Yufei Huang <[email protected]> * Add obsolete attributes that is mentioned in review comments. and fix some comment. * Update DocumentBuilderWrapper.cs * fix .gitignore file for docfx init --------- Co-authored-by: Yufei Huang <[email protected]>
This PR add doc comments that are related to
docfx.json
configs.and adding some obsolete attributes.
Purpose of this PR
Preparation to create JSON schema document for
docfx.json
from C# code and doc comments. (#8968)Add Obsolete attribute
This PR add `[Obsolete] property to following properties
dest
(As commented on Behaviors when specifying `dest` and `output` options simultaneously #8967).output
property is added recently.dest
usage should be deprecated)versions
(It's seems remaining for compatibility purpose)Documentation comments
Almost doc comments are taken from following contents.
Some properties are not documented. and no working example found.
So I've added doc comment these property.
** List of undocumented
build
section properties**pairing
xrefTags
tagParameters
versions