- Getting Started
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
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
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.
- 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
- Teams & Sharepoint
- Shared Project Calendar
- ASAM Project Roles
- ASAM DCO for Open Source Projects
- ASAM Quality Guidelines
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.
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