Contribution Workflow for Writers [Technical & Non-Technical]
COLLABOCATE'S COLLABO COMMUNITY TECHNICAL & NON-TECHNICAL WRITING AND DOCUMENTATION CONTRIBUTION WORKFLOW
General Information about projects
Collabocate OSC Projects: OverviewMaking and submitting changes for documentation projects
See tabs below for the different methods/mediums you can use to edit technical or non-technical writing and documentation projects.
Request access to GitBook
Our community and project documentation reside on GitBook. Request access to GitBook from the @community-coordinator, so that you can be given editor access.
Edit and submit change requests
Locate the documentation project you want to contribute to on GitBook
Click on the edit button on the top right corner of the document
Make desired changes to the pages as needed
Once satisfied/done, click on request review button. Reviewer(s) will check out your changes, approve or request you to fix things in your submission as required.
GitHub repository for documentation projects
Our GitBook community and project docs are synced to one GitHub repository, so that you can find them and edit them on GitHub too.
GitHub repository link: https://github.com/collabocate-osc/docs
Engineering workflow: Git branch name & technical writing
If you are submitting via GitHub, use the naming convention for branch names from the Engineering contribution workflow. The Engineering workflow documentation is also helpful to finding project repos and local development setup, in the case of technical writing.
EngineeringEdit and submit pull requests
See the guidelines for submitting pull requests to any of our GitHub repositories in the page below.
Pull Request GuidelinesVideo and Image dimensions
If the issue ticket you are taking on involves videos or images, the videos and images that you submit should have these dimensions:
Video dimension: 1280 x 720
Image dimensions: preferably 1280 x 720, but this can change depending on the needs of the doc or markdown involved.
Last updated
Was this helpful?