Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
W
wiki
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 0
    • Issues 0
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Merge Requests 0
    • Merge Requests 0
  • CI / CD
    • CI / CD
    • Pipelines
    • Jobs
    • Schedules
  • Operations
    • Operations
    • Environments
  • Packages & Registries
    • Packages & Registries
    • Package Registry
    • Container Registry
  • Analytics
    • Analytics
    • CI / CD
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
  • Simulation
  • wiki
  • Wiki
  • Home

Home

Last edited by Katharina Loehberg Nov 23, 2020
Page history
  • Overview
    • Communication Channels
    • Setting up a Meeting
    • ASAM Document Language & Formats
    • Further Project Guidelines
      • Project Guidelines
  • Getting Started
    • First Time Tool Setup
      • Further Guides
    • Repository Workflow
      • Further Repository Guidelines

Overview

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) - See the Teams Guide

Gitlab : All source code and standard relevant documentation. Issues relevant to deliverables should be created here. See Workflow Overview

Github : ADD

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. See OpenX Calendar

Setting up a Meeting

Meeting Guidelines

ASAM Document Language & Formats

  • All ASAM OpenX Standards are written using the Asciidoc format asciidoc Homepage

  • AsciiDoc is a mature, plain-text writing format for authoring notes, articles, documentation, books, ebooks, web pages, slide decks, blog posts, man pages and more.

  • AsciiDoc belongs to the family of lightweight markup languages, the most renowned of which is Markdown. 

You write an AsciiDoc document the same way you would write a normal text document. There are no markup tags or weird format notations. AsciiDoc files are designed to be viewed, edited and printed directly or translated to other presentation formats.

Main advantages:

  • Can be edited in any text editor or using the online editor in Gitlab
  • Focus on content not on formatting!
  • Versionable and diffable – i.e. we can tell who did what, when and where!
  • In the end we can deliver an interactive html instead of a static pdf

See the AsciiDoc Guide for a guide on writing Asciidoc.

Further Project Guidelines

Project Guidelines

  • Teams & Sharepoint
  • Shared Project Calendar
  • ASAM Project Roles
  • ASAM DCO for Open Source Projects
  • ASAM Quality Guidelines

Getting Started

First Time Tool Setup

See the 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 for information on getting setup with Microsoft Teams.

Finally, synchronise with the OpenX calendar, a shared calendar across all ASAM OpenX projects that lists all meetings taking place.

Further Guides

  • VSCode
  • AsciiDoc

Repository Workflow

See the Workflow Overview for a walkthrough on how to work on actively developing the ASAM standards.

For a list of available labels in ASAM repositories, see this overview of labels


Further Repository Guidelines

  • Commit message guidelines - Formatting guidelines for commit messages on commits/merges to the ASAM master branches
  • Git
  • Resolving merge conflicts
  • Branching
  • Forking
Clone repository

Home

Getting Started

Tools Overview

  • Teams & Sharepoint
  • Shared Project Calendar
  • Gitlab
  • Github
  • Mailing List

First Time Setup



Project Guidelines

  • Project Roles
  • DCO for Open Source Projects
  • Quality Guidelines
  • Meeting Guidelines

Tooling Guides

Contributing to an OpenX Project

  • Introduction to Git
  • Workflow Overview
  • Git
  • Branching
  • Branch naming Conventions
  • Commit message guidelines
  • Available Issue and MR Labels
Trouble Shooting
  • Resolving merge conflicts
  • VSCode
  • AsciiDoc

Teams & Sharepoint

Shared Project Calendar


  • Sidebar