Keep test case doc and test script in a separate branch that never merge with the master. Test case doc needs not be browsable. Test case doc is in fact quite simple HTML. We can just convert the current MS Word into HTML and Test case doc will be edited in that format.
User Guide
Use another repo, i want user guide to be browsable without score deployment, so it should be Github Pages. I looked at Gitbook a bit. I am not sure if I want the user guide content to be hosted somewhere else not inside the application. In interest of time, we can keep user guide with the application for now. We can look into other benefits Gitbook may bring later. At this point, we upload the Word doc to a Wiki page and the generated HTMLs to the repo. If Sakis can help me move User Guide to Gitbook b/f he leave, I think I might be fine. I don’t know how to sync the release though.
User Guide needs to be in another repo because I want Contribution Guide to be browsable as well but I don’t want Contribution Guide to be included in the release. But GitHub Pages can only point to one root.
Contribution guideline should be browsable as well, but don't want it in the release. So it should be Github Pages as well. Contribution Guide should be in a separate branch call GithubPages branch. ReadMe file can have a link to that.
The Release Detail page including upgrade. It is convenient to be browsable because people might want to read before download or more importantly it can be read when deployment is via docker. Since the content is cumulative, it does not benefit much from the version control system. It is okay to keep the content on the Wiki. Put a link to this page in the ReadMe.
Installation Guides - move this to User Guide. Going forward installation guide can include non-docker installation. Installation guide is separate from the Release Detail b/c the content is relatively static across version and this refers to only brown field installation. Going forward there has to be installation w/o any standard content and then there is a reference to data loader.