Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add documentation tree structure #14

Merged
merged 3 commits into from
Jan 21, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
nav:
- Introduction: index.md
- installation
- tutorials
- how-to-guides
- design
- contributing
- help
7 changes: 7 additions & 0 deletions docs/contributing/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
nav:
- index.md
- coding-guidelines
- testing-guidelines
- documentation-guidelines
- pull-request-guidelines
- discussion-guidelines
4 changes: 4 additions & 0 deletions docs/contributing/coding-guidelines/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
nav:
- index.md
- Language-specific coding guidelines: languages
- ROS nodes coding guidelines: ros-nodes
7 changes: 7 additions & 0 deletions docs/contributing/coding-guidelines/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Coding guidelines

!!! warning

Under Construction

## Common guidelines
11 changes: 11 additions & 0 deletions docs/contributing/coding-guidelines/languages/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
nav:
- index.md
- cpp.md
- python.md
- shell-scripts.md
- markdown.md
- cmake.md
- package-xml.md
- ros2-interfaces.md
- docker.md
- github-actions.md
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/languages/cmake.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# CMake

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/languages/cpp.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# C++

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/languages/docker.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Docker

!!! warning

Under Construction
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# GitHub Actions

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/languages/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Language-specific coding guidelines

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/languages/markdown.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Markdown

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/languages/package-xml.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# package.xml

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/languages/python.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Python

!!! warning

Under Construction
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# ROS 2 interfaces

!!! warning

Under Construction
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Shell scripts

!!! warning

Under Construction
11 changes: 11 additions & 0 deletions docs/contributing/coding-guidelines/ros-nodes/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
nav:
- index.md
- class-design.md
- console-logging.md
- coordinate-system.md
- directory-structure.md
- launch-files.md
- naming.md
- parameters.md
- task-scheduling.md
- topic-namespaces.md
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/ros-nodes/class-design.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Class design

!!! warning

Under Construction
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Console logging

!!! warning

Under Construction
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Coordinate system

!!! warning

Under Construction
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Directory structure

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/ros-nodes/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# ROS nodes coding guidelines

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/ros-nodes/launch-files.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Launch files

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/ros-nodes/naming.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Topic namespaces

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/contributing/coding-guidelines/ros-nodes/parameters.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Parameters

!!! warning

Under Construction
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Task scheduling

!!! warning

Under Construction
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Topic namespaces

!!! warning

Under Construction
2 changes: 2 additions & 0 deletions docs/contributing/discussion-guidelines/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
nav:
- index.md
5 changes: 5 additions & 0 deletions docs/contributing/discussion-guidelines/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Discussion guidelines

!!! warning

Under Construction
2 changes: 2 additions & 0 deletions docs/contributing/documentation-guidelines/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
nav:
- index.md
5 changes: 5 additions & 0 deletions docs/contributing/documentation-guidelines/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Documentation guidelines

!!! warning

Under Construction
15 changes: 15 additions & 0 deletions docs/contributing/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Contributing

!!! warning

Under Construction

## Contribution workflows

### Issues

### Discussions

### Small pull requests

### Large pull requests
2 changes: 2 additions & 0 deletions docs/contributing/pull-request-guidelines/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
nav:
- index.md
5 changes: 5 additions & 0 deletions docs/contributing/pull-request-guidelines/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Pull request guidelines

!!! warning

Under Construction
2 changes: 2 additions & 0 deletions docs/contributing/testing-guidelines/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
nav:
- index.md
5 changes: 5 additions & 0 deletions docs/contributing/testing-guidelines/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Testing guidelines

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/design/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
nav:
- index.md
- component-interfaces
- AD API: ad-api
- configuration-management
2 changes: 2 additions & 0 deletions docs/design/ad-api/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
nav:
- index.md
5 changes: 5 additions & 0 deletions docs/design/ad-api/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# AD API

!!! warning

Under Construction
2 changes: 2 additions & 0 deletions docs/design/component-interfaces/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
nav:
- index.md
5 changes: 5 additions & 0 deletions docs/design/component-interfaces/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Component interfaces

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/design/configuration-management/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
nav:
- index.md
- development-process.md
- repository-structure.md
- release-process.md
5 changes: 5 additions & 0 deletions docs/design/configuration-management/development-process.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Development process

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/design/configuration-management/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Configuration management

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/design/configuration-management/release-process.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Release process

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/design/configuration-management/repository-structure.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Repository structure

!!! warning

Under Construction
11 changes: 11 additions & 0 deletions docs/design/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# Design

!!! warning

Under Construction

## Component interfaces

## AD API

## Configuration management
4 changes: 4 additions & 0 deletions docs/help/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
nav:
- index.md
- support-guidelines.md
- docs-guide.md
15 changes: 15 additions & 0 deletions docs/help/docs-guide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Docs guide

!!! warning

Under Construction

This page explains documentations sites that are useful for Autoware and ROS development.

## [The Autoware Foundation](https://www.autoware.org/)

## [Autoware Documentation](https://autowarefoundation.github.io/autoware-documentation) (this site)

## [Autoware Universe Documentation](https://autowarefoundation.github.io/autoware.universe)

## [ROS Docs Guide](https://docs.ros.org/en/rolling/Docs-Guide.html)
5 changes: 5 additions & 0 deletions docs/help/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Help

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/help/support-guidelines.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Support guidelines

!!! warning

Under Construction
2 changes: 2 additions & 0 deletions docs/how-to-guides/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
nav:
- index.md
11 changes: 11 additions & 0 deletions docs/how-to-guides/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# How-to guides

!!! warning

Under Construction

- Write an Autoware package
- Add a message
- Debug Autoware
- Integrate Autoware with a real vehicle
- etc.
21 changes: 20 additions & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
@@ -1 +1,20 @@
# autoware-documentation
# Autoware Documentation

!!! warning

Under Construction

## About Autoware

Autoware is the world’s leading open-source software project for autonomous driving. Autoware is built on Robot Operating System (ROS) and enables commercial deployment of autonomous driving in a broad range of vehicles and applications.

Please see [here](https://www.autoware.org/autoware) for more details.

## Getting started

- [Installation](installation)
- [Tutorials](tutorials)
- [How-to guides](how-to-guides)
- [Design](design)
- [Contributing](contributing)
- [Help](help)
5 changes: 5 additions & 0 deletions docs/installation/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
nav:
- index.md
- autoware
- tools-for-users
- tools-for-developers
4 changes: 4 additions & 0 deletions docs/installation/autoware/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
nav:
- index.md
- local-installation.md
- docker-installation.md
5 changes: 5 additions & 0 deletions docs/installation/autoware/docker-installation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Docker installation

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/installation/autoware/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Installation of Autoware

!!! warning

Under Construction
5 changes: 5 additions & 0 deletions docs/installation/autoware/local-installation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Local installation

!!! warning

Under Construction
7 changes: 7 additions & 0 deletions docs/installation/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Installation

!!! warning

Under Construction

## Supported platforms
Loading