An open API service indexing awesome lists of open source software.

https://github.com/trimble-oss/contribute

The home of onboarding and contribution guidelines for Trimble GitHub users and Trimble OSS contributors.
https://github.com/trimble-oss/contribute

github innersource opensource oss trimble

Last synced: 3 months ago
JSON representation

The home of onboarding and contribution guidelines for Trimble GitHub users and Trimble OSS contributors.

Awesome Lists containing this project

README

          

![Trimble <3 GitHub](/assets/img/trimble-heart-github.svg)

[Help](#need-help) | [Getting Started](#getting-started) | [Publishing](#publishing) | [Copilot](#github-copilot)

## Need Help?

First, please make sure you have read and followed all of the [instructions below](#getting-started). If you still need help, please request assistance via the [Trimble GitHub Charlie Page](https://charlie.trimble.com/channels/204800003/TrimbleGitHub).

🔍 Already set up? You can **Go straight to the [Trimble GitHub Organization](https://github.com/trimble-oss)**

## Getting Started

**Please be sure you read through the following bullet points and take any necessary action.**

- Add the `GitHub - Trimble` application from your Okta homepage.
- Create a GitHub account if you don't already have one.
- **Update**: It is now recommended that you create a Trimble specific GitHub account rather than using an existing personal GitHub username. This is particularly important if you want to use GitHub Copilot as using a personal GitHub account risks combining personal data and business data.
- **Replace the default GitHub account avatar with something that uniquely identifies you.**
- **Read the [Contributor Guidelines](/guidelines/index.md). No really, we mean it, read them!**
- Join the [Trimble GitHub Channel on Charlie](https://app.happeo.com/channels/204800003/TrimbleGithub)!

### Request to Join an Organization

The following instructions are sufficient for both adding you as a licensed Trimble GitHub user, and for receiving an invitation to join the **`trimble-oss`** organization.

**If you want to join a different organization**, please continue to follow the instructions below to receive a Trimble license for GitHub. However, you will also need to specifically request access to that organization by finding and contacting an [administrator for that organization](https://trimble.domo.com/page/876535730).

---

Use the following template to prepare and [send an email to the admins mailing list](mailto:trimble-oss-contrib-admins-ug@trimble.com) requesting to join.

**Please include your GitHub username**, *not* your Trimble email address in your message.

```text

Dear Trimble GitHub Administrators,

I have added the GitHub - Trimble application to my Okta account. Please grant access for my GitHub account:

@yourgithubusername (not your Trimble email address)

{ Tell us a bit about yourself and your role at Trimble. }

I am joining because I...

{ why you want to join GitHub }

Thanks,

{your name}

```

## Publishing

**Ready to publish a project to the public?**

- Read and ensure all requirements are met in the [Trimble OSS - Open Source Publication Policies and Procedures](https://docs.google.com/document/d/1zL_qjgBfECiQ-3KtYRFgVi3zZESPpSYF1mVi755cu_M)
- Contact [trimble-oss-contrib-admins-ug@trimble.com](mailto:trimble-oss-contrib-admins-ug@trimble.com) when you are ready for a pre-publication review and we will work with you to get your project published

## Github Copilot

🔍 Looking for **GitHub Copilot**?
- [Request a License](https://support.trimble.cloud/support/catalog/items/42)
- Read the [Getting Started Guide](https://docs.google.com/document/d/1qsuPPdbuDQxzii2c9ucvwdWsNRAf09mAwMOpzUjt5UQ/edit#heading=h.kt03vcur1pr9)