Git-TechReview, GTR, is designed to assist Microsoft Content Developers with documentation collaboration. Markdown and Git work well for public collaboration and simple edits, but it does not support rich commenting, multi-party, simultaneous change tracking, and real-time collaboration. GTR enables this by implementing an export and import to DOCX format for collaboration using Word Online. You can even start a new document in DOCX, collaborate with co-workers in a familiar format, and then import to markdown for final editing and publishing to your site.
Getting going with the extension for Visual Studio Code is simple. Just follow these steps:
Export to DOCX
This will export the Markdown file as a DOCX file to a folder that you choose.
Import to MD
This will import a DOCX file into a Markdown file in the current Visual Studio Code working folder. It will either overwrite an existing file or create a new one using the name of the DOCX file replacing the DOCX extension with MD.
Recommendation for Importing an Exported DOCX file
Due to the current known issues with the Import to MD process, we recommend importing to a new markdown file and diff'ing the original and new markdown files. This can be done by renaming your DOCX prior to starting the Import to MD process.
Recommendation for Importing a new DOCX file
Details to come later.
Initial release of Git-TechReview on 7/26/2018.