For the complete documentation index, see llms.txt. This page is also available as Markdown.

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: Overview

Making 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.

Engineering

Edit and submit pull requests

See the guidelines for submitting pull requests to any of our GitHub repositories in the page below.

Pull Request Guidelines

Video 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?