# GitHub team module

Terraform module which creates team resource on GitHub.

## Usage

```hcl
module "tean" {
  source = "path/to/github/team"
  
  name        = "my-team"
}
``` 

## Providers

| Name | Version |
|------|---------|
| github | = v2.4.0 |

## Inputs

| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:-----:|
| description | A description of the team. | `string` | `"Managed by Terraform"` | no |
| ldap\_dn | The LDAP Distinguished Name of the group where membership will be synchronized. Only available in GitHub Enterprise. | `any` | n/a | yes |
| name | The name of the team. | `string` | n/a | yes |
| parent\_team\_id | The ID of the parent team, if this is a nested team. | `any` | n/a | yes |
| privacy | The level of privacy for the team. Must be one of secret or closed. Defaults to secret. | `strign` | `"secret"` | no |
| team\_membership | The map of permissions. If empty only owner has access. | `map(object({ username = string, role = string }))` | `{}` | no |

## Outputs

| Name | Description |
|------|-------------|
| id | The ID of the created team. |
| slug | The slug of the created team, which may or may not differ from name, depending on whether name contains "URL-unsafe" characters. |