|
|
[[_TOC_]]
|
|
|
|
|
|
|
|
|
# Getting Started
|
|
|
# Overview
|
|
|
|
|
|
## Where to Work
|
|
|
### For new Standards/Activities:
|
|
|
* Shared documents not relevant to deliverables (presentations, notes, minutes, papers, etc.) via Teams chat & shared files - i.e. things that do not need to be or cannot be versioned
|
|
|
* Anything that is relevant to deliverables (e.g. outlines, text etc.) -> Gitlab!
|
|
|
|
|
|
## Communication Channels
|
|
|
**Microsoft Teams**
|
|
|
: Chat, conferencing, document folder for sharing documents (e.g. research papers, notes, videos, anything that does not need to be versioned)
|
|
|
: Chat, conferencing, document folder for sharing documents (e.g. research papers, notes, videos, anything that does not need to be versioned) - See the [Teams Guide](/docs/project_guidelines/Microsoft-Teams-and-Sharepoint)
|
|
|
|
|
|
[**Gitlab**](https://code.asam.net) / [**Github**](https://github.com/asam-ev)
|
|
|
: All source code and standard relevant documentation. Issues relevant to deliverables should be created here.
|
|
|
: All source code and standard relevant documentation. Issues relevant to deliverables should be created here. See [Workflow Overview](#repository-workflow)
|
|
|
|
|
|
**Mailing list**
|
|
|
: Project level communication will be duplicated here from the teams channel for redundancy (e.g. project meetings, announcements)
|
|
|
|
|
|
**OpenXCalendar**
|
|
|
: Subscribable, shared calendar for all OpenX projects - this lists (filterable) all meetings for each project.
|
|
|
: Subscribable, shared calendar for all OpenX projects - this lists (filterable) all meetings for each project. See [OpenX Calendar](/docs/project_guidelines/Shared-OpenX-Calendar)
|
|
|
|
|
|
## ASAM Document Language & Formats
|
|
|
|
... | ... | @@ -39,15 +38,26 @@ |
|
|
|
|
|
|
|
|
>See the [AsciiDoc Guide](/docs/other-guides/Asciidoc-Guide) for a guide on writing Asciidoc.
|
|
|
---
|
|
|
## First Time Setup
|
|
|
|
|
|
## Further Project Guidelines
|
|
|
### Project Guidelines
|
|
|
- [Teams & Sharepoint](/docs/project_guidelines/Microsoft-Teams-and-Sharepoint)
|
|
|
- [Shared Project Calendar](/docs/project_guidelines/Shared-OpenX-Calendar)
|
|
|
- [ASAM Project Roles](/docs/project_guidelines/ASAM-Project-Roles)
|
|
|
- [ASAM DCO for Open Source Projects](/docs/project_guidelines/ASAM-DCO)
|
|
|
- [ASAM Quality Guidelines](/docs/project_guidelines/Quality-Guidelines)
|
|
|
|
|
|
# Getting Started
|
|
|
## First Time Tool Setup
|
|
|
See the [setup guide](/docs/project_guidelines/Setup-Guide) for a step-by-step on installing the tools we recommend for interacting with ASAM standards and repositories.
|
|
|
|
|
|
Additionally, see the guide to [Teams & Sharepoint](/docs/project_guidelines/Microsoft-Teams-and-Sharepoint) for information on getting setup with Microsoft Teams.
|
|
|
|
|
|
Finally, [synchronise with the OpenX calendar](/docs/project_guidelines/Shared-OpenX-Calendar), a shared calendar across all ASAM OpenX projects that lists all meetings taking place.
|
|
|
|
|
|
---
|
|
|
### Further Guides
|
|
|
- [VSCode](/docs/other-guides/VSCode-Guide)
|
|
|
- [AsciiDoc](/docs/other-guides/Asciidoc-Guide)
|
|
|
|
|
|
## Repository Workflow
|
|
|
See the [Workflow Overview](/docs/git/Workflow) for a walkthrough on how to work on actively developing the ASAM standards.
|
... | ... | @@ -62,12 +72,3 @@ For a list of available labels in ASAM repositories, see this [overview of label |
|
|
- [Resolving merge conflicts](/docs/git/Resolving-Merge-Conflicts)
|
|
|
- [Branching](/docs/git/Branching)
|
|
|
- [Forking](/docs/git/Forking) |
|
|
|
|
|
|
|
|
---
|
|
|
### Other Guides
|
|
|
- [VSCode](/docs/other-guides/VSCode-Guide)
|
|
|
- [AsciiDoc](/docs/other-guides/Asciidoc-Guide)
|
|
|
|
|
|
---
|
|
|
|