-
Notifications
You must be signed in to change notification settings - Fork 19
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
Implementation of a new DocAssembler tool #87
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
All up, looks great! And This is going to definitely be useful for quite some people! Couple of comments, I didn't find anything critical.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, great addition!
This is a new tool in the family of DocFx Companion Tools. It can be used to assemble documentation and assets from various locations on disk and assemble in one place. The tool will copy and change the links to the new locations of files. It can also change paths and contents using regular expressions. External links (outside of the documentation hierarchy) can be prefixed with a URL.
If the input files are validated with DocLinkChecker, the outcome of DocAssembler will also be validated with DocLinkChecker unless there are configuration errors.
The configuration is done in a JSON file. Everything is documented in the main README. There is also a Test project added with unit tests for all of the functionality.