update authored by Benjamin ENGEL (ASAM)'s avatar Benjamin ENGEL (ASAM)
[[_TOC_]] [[_TOC_]]
# Getting Started # Overview
## Where to Work ## 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 * 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! * Anything that is relevant to deliverables (e.g. outlines, text etc.) -> Gitlab!
## Communication Channels ## Communication Channels
**Microsoft Teams** **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) [**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** **Mailing list**
: Project level communication will be duplicated here from the teams channel for redundancy (e.g. project meetings, announcements) : Project level communication will be duplicated here from the teams channel for redundancy (e.g. project meetings, announcements)
**OpenXCalendar** **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 ## ASAM Document Language & Formats
...@@ -39,15 +38,26 @@ ...@@ -39,15 +38,26 @@
>See the [AsciiDoc Guide](/docs/other-guides/Asciidoc-Guide) for a guide on writing Asciidoc. >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. 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. 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. 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 ## Repository Workflow
See the [Workflow Overview](/docs/git/Workflow) for a walkthrough on how to work on actively developing the ASAM standards. 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 ...@@ -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) - [Resolving merge conflicts](/docs/git/Resolving-Merge-Conflicts)
- [Branching](/docs/git/Branching) - [Branching](/docs/git/Branching)
- [Forking](/docs/git/Forking) - [Forking](/docs/git/Forking)
---
### Other Guides
- [VSCode](/docs/other-guides/VSCode-Guide)
- [AsciiDoc](/docs/other-guides/Asciidoc-Guide)
---