Personally I think that works and gives you all of the "edit-locally" benefits (Accessibility, hotkeys, versions, distributed/backed up etc). What that doesn't give you is a few other important features.
My coworkers are concerned with the following:
- Highlight and right click docs -> new ticket
- Drag and drop flow chart creation
- Non-developers can document and plan
- Full text search
- "Name spaced"/grouped documentation
- Third party integration
I agree that most of those are not in the wiki nor in GitLab pages.
For non developers you can make it easier to edit by linking the bottom of each page to the reposity. See our website or docs pages for an example of that.
My coworkers are concerned with the following: