add some documentation structure
This commit is contained in:
parent
51cd583dff
commit
5ca311d240
15 changed files with 168 additions and 2 deletions
16
docs/concepts-and-configurations/documentation-structure.md
Normal file
16
docs/concepts-and-configurations/documentation-structure.md
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
---
|
||||
title: Documentation Structure
|
||||
order: 1
|
||||
summary: >-
|
||||
How our documentation is organized and what we do to balance ease of writing and understanding.
|
||||
---
|
||||
|
||||
!!! info "ToDo"
|
||||
|
||||
This section needs updating
|
||||
|
||||
- Docs should be english
|
||||
- Guides are for step-by-step things
|
||||
- Guides always have a "Goal" explicitly formulated
|
||||
- Concepts and Configuration aim to make readers understand something in detail
|
||||
|
||||
10
docs/concepts-and-configurations/index.md
Normal file
10
docs/concepts-and-configurations/index.md
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
---
|
||||
title: Concepts and Configurations
|
||||
order: 0
|
||||
sidebar_title: Start
|
||||
summary: >-
|
||||
Concepts and configurations is a selection of how we organize and manage our infrastructure. You can find here how processes are planned, how services are expected to integrate with each other and how they are configured.
|
||||
|
||||
---
|
||||
|
||||
|
||||
0
docs/concepts-and-configurations/managed-resources.md
Normal file
0
docs/concepts-and-configurations/managed-resources.md
Normal file
0
docs/concepts-and-configurations/networking_in_z9.md
Normal file
0
docs/concepts-and-configurations/networking_in_z9.md
Normal file
17
docs/concepts-and-configurations/who-we-are.md
Normal file
17
docs/concepts-and-configurations/who-we-are.md
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
---
|
||||
title: Who We Are and What We Do
|
||||
---
|
||||
|
||||
We are the infrastructure team of the [Chaos Computer Club Hansestadt Hamburg](https://hambugr.ccc.de).
|
||||
We operate all the infrastructure related to that club in a fun, sustainable and cooperative way.
|
||||
We are always open for new ideas and discussions and you can reach us at [infra@hamburg.ccc.de](mailto:infra@hamburg.ccc.de) or directly in the hackerspace.
|
||||
|
||||
In doing so we operate on common values of **trust**, **fun**, helping each other learn, and of course the [Hacker Ethics](https://www.ccc.de/en/hackerethics).
|
||||
|
||||
Topics that interest us and which we engage in:
|
||||
|
||||
- Networking in our local club (See [Networking in Z9](./networking_in_z9.md))
|
||||
- Operating our own bare metal servers in Club and our local data center (See [Managed Resources](./managed-resources.md))
|
||||
- Providing services for our members and groups (See [Managed Resources](./managed-resources.md))
|
||||
- Hacking on (self hosted) Smart-Home services and automation for our space (See [Club Automation](./club-automation.md))
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue