-
Notifications
You must be signed in to change notification settings - Fork 18
Home
Welcome to the user-documentation wiki!
Goals
-
Enable devs to draft expected use cases
-
Capture code examples in asciidoc
-
Provide 'raw' material to writers
-
Separate eng-doc requirements from CCS-doc requirements
Procedure
When a dev identifies some procedure that requires documentation:
-
Write up a procedure as a new page on https://github.com/integr8ly/user-documentation/wiki
-
Eng review can be as simple as reviewer editing that page with 'lgtm'
-
Dev adds link to page in the associated jira
-
When documenting a user story, a writer can reference this material.
The wiki supports asciidoc, so when an existing procedure is being modified, the eng can get the source material from: https://gitlab.cee.redhat.com/RedHatManagedIntegration-documentation/rhmi-docs/
or from https://github.com/integr8ly/user-documentation/tree/master/modules/ROOT/pages (could be stale)