docs-onboarding/README.md

# Engineering Portal

This space is for the engineering team to share knowledge, resources, and best practices.

## Sructure of the repository

We are trying to keep the repositories small and structured. The following overview shows the general structure and the most important repositories.

![Engineering Portal Structure](resources/diagrams/engineer-portal-structure.png)

### Documentation repositories

The documentation repositories should help to find best know how, practices and guidelines. No matter if you are new to the team or if you have been working in an different area in the past, you should be able to find the information you need.

- [docs-onboarding](https://xwr.visualstudio.com/jambor.pro/_git/docs-onboarding): the current repository you are reading. It should contain all information needed to get started.

### Infrastructure repositories

The infrastructure repositories should contain all information about the infrastructure we are using and it's configuration.

- [infra-ansible-adoconfiguration](https://xwr.visualstudio.com/jambor.pro/_git/infra-ansible-adoconfiguration): Centralised Ansible roles to configure Azure DevOps Organiztations.

- [infra-ansible-developersetup](https://xwr.visualstudio.com/jambor.pro/_git/infra-ansible-developersetup): Centralised Ansible roles to configure developer machines and setup the required tools.

- [infra-ansible-serverconfiguration](https://xwr.visualstudio.com/jambor.pro/_git/infra-ansible-serverconfiguration): Centralised Ansible roles to configure servers.

- [infra-terraform-modulelibrary](https://xwr.visualstudio.com/jambor.pro/_git/infra-terraform-modulelibrary): We are maintaining Terraform modules which should ensure constant quality and improvement.

### CI/CD repositories

The CI/CD repositories should contain all information about the CI/CD pipelines we are using.

- [cicd-pipeline-library](https://xwr.visualstudio.com/jambor.pro/_git/cicd-pipeline-library): We are maintaining Azure DevOps Pipeline templates which should ensure constant quality and improvement.
remove test files add overview image 2024-04-22 08:16:27 +02:00			`# Engineering Portal`
Updated README 2024-04-18 19:13:09 +00:00
remove test files add overview image 2024-04-22 08:16:27 +02:00			`This space is for the engineering team to share knowledge, resources, and best practices.`
Updated README.md 2024-04-18 19:25:42 +00:00
remove test files add overview image 2024-04-22 08:16:27 +02:00			`## Sructure of the repository`
Updated README 2024-04-18 19:13:09 +00:00
add info and first references for docs repos 2024-04-22 08:25:05 +02:00			`We are trying to keep the repositories small and structured. The following overview shows the general structure and the most important repositories.`

remove test files add overview image 2024-04-22 08:16:27 +02:00			`![Engineering Portal Structure](resources/diagrams/engineer-portal-structure.png)`
add info and first references for docs repos 2024-04-22 08:25:05 +02:00
add further suggestions for content 2024-05-11 20:45:40 +02:00			`### Documentation repositories`
add info and first references for docs repos 2024-04-22 08:25:05 +02:00
			`The documentation repositories should help to find best know how, practices and guidelines. No matter if you are new to the team or if you have been working in an different area in the past, you should be able to find the information you need.`

fix: outgoing url link name 2024-05-11 21:27:00 +02:00			`- [docs-onboarding](https://xwr.visualstudio.com/jambor.pro/_git/docs-onboarding): the current repository you are reading. It should contain all information needed to get started.`
add info and first references for docs repos 2024-04-22 08:25:05 +02:00
add further suggestions for content 2024-05-11 20:45:40 +02:00			`### Infrastructure repositories`

			`The infrastructure repositories should contain all information about the infrastructure we are using and it's configuration.`

fix: update repo overview and diagram 2024-05-12 14:00:17 +02:00			`- [infra-ansible-adoconfiguration](https://xwr.visualstudio.com/jambor.pro/_git/infra-ansible-adoconfiguration): Centralised Ansible roles to configure Azure DevOps Organiztations.`

			`- [infra-ansible-developersetup](https://xwr.visualstudio.com/jambor.pro/_git/infra-ansible-developersetup): Centralised Ansible roles to configure developer machines and setup the required tools.`

			`- [infra-ansible-serverconfiguration](https://xwr.visualstudio.com/jambor.pro/_git/infra-ansible-serverconfiguration): Centralised Ansible roles to configure servers.`

fix: outgoing urls 2024-05-11 21:26:17 +02:00			`- [infra-terraform-modulelibrary](https://xwr.visualstudio.com/jambor.pro/_git/infra-terraform-modulelibrary): We are maintaining Terraform modules which should ensure constant quality and improvement.`
add further suggestions for content 2024-05-11 20:45:40 +02:00
			`### CI/CD repositories`

			`The CI/CD repositories should contain all information about the CI/CD pipelines we are using.`

fix: outgoing urls 2024-05-11 21:26:17 +02:00			`- [cicd-pipeline-library](https://xwr.visualstudio.com/jambor.pro/_git/cicd-pipeline-library): We are maintaining Azure DevOps Pipeline templates which should ensure constant quality and improvement.`