chore: update docs

Author: acch

.gitignore

@@ -45,3 +45,4 @@ coverage.out
 !CHANGELOG.md
 !CONTRIBUTING.md
 !README.md
+!docs/**/*.md

README.md

@@ -2,7 +2,7 @@
 
 ![Tests](https://github.com/svalabs/terraform-provider-forgejo/actions/workflows/test.yml/badge.svg)
 ![Release](https://github.com/svalabs/terraform-provider-forgejo/actions/workflows/release.yml/badge.svg)
-![Test Coverage](https://img.shields.io/badge/Coverage-74.4%25-brightgreen?logo=go)
+![Test Coverage](https://img.shields.io/badge/Coverage-74.7%25-brightgreen?logo=go)
 ![Version](https://img.shields.io/github/v/release/svalabs/terraform-provider-forgejo?logo=terraform&label=Version)
 ![License](https://img.shields.io/github/license/svalabs/terraform-provider-forgejo?logo=github&label=License)
 
@@ -24,6 +24,7 @@ Resources:
 - `forgejo_organization` ([documentation](docs/resources/organization.md))
 - `forgejo_organization_action_secret` ([documentation](docs/resources/organization_action_secret.md))
 - `forgejo_organization_action_variable` ([documentation](docs/resources/organization_action_variable.md))
+- `forgejo_personal_access_token` ([documentation](docs/resources/personal_access_token.md))
 - `forgejo_repository` ([documentation](docs/resources/repository.md))
 - `forgejo_repository_action_secret` ([documentation](docs/resources/repository_action_secret.md))
 - `forgejo_repository_action_variable` ([documentation](docs/resources/repository_action_variable.md))
@@ -40,6 +41,7 @@ Data Sources:
 - `forgejo_gpg_key` ([documentation](docs/data-sources/gpg_key.md))
 - `forgejo_organization` ([documentation](docs/data-sources/organization.md))
 - `forgejo_organization_action_variable` ([documentation](docs/data-sources/organization_action_variable.md))
+- `forgejo_personal_access_token` ([documentation](docs/data-sources/personal_access_token.md))
 - `forgejo_repository` ([documentation](docs/data-sources/repository.md))
 - `forgejo_repository_action_variable` ([documentation](docs/data-sources/repository_action_variable.md))
 - `forgejo_ssh_key` ([documentation](docs/data-sources/ssh_key.md))

docs/data-sources/personal_access_token.md

@@ -0,0 +1,52 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "forgejo_personal_access_token Data Source - forgejo"
+subcategory: ""
+description: |-
+  Forgejo personal access token data source.
+---
+
+# forgejo_personal_access_token (Data Source)
+
+Forgejo personal access token data source.
+
+## Example Usage
+
+```terraform
+terraform {
+  required_providers {
+    forgejo = {
+      source = "svalabs/forgejo"
+    }
+  }
+}
+
+provider "forgejo" {
+  host = "http://localhost:3000"
+}
+
+# Existing user
+data "forgejo_user" "test_user" {
+  login = "test_user"
+}
+
+# Existing personal access token
+data "forgejo_personal_access_token" "test_token" {
+  user = data.forgejo_user.test_user.login
+  name = "test token"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) Name of the personal access token.
+- `user` (String) Name of the user.
+
+### Read-Only
+
+- `id` (Number) ID of the personal access token.
+- `scopes` (Set of String) Scopes of the personal access token.
+- `token_last_eight` (String) Last eight characters of the personal access token.

docs/resources/personal_access_token.md

@@ -0,0 +1,63 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "forgejo_personal_access_token Resource - forgejo"
+subcategory: ""
+description: |-
+  Forgejo personal access token resource.
+  Note: Due to an upstream limitation, one cannot create access tokens when authorized with access tokens. Use basic-auth instead.
+---
+
+# forgejo_personal_access_token (Resource)
+
+Forgejo personal access token resource.
+
+**Note**: Due to an upstream limitation, one cannot create access tokens when authorized with access tokens. Use basic-auth instead.
+
+## Example Usage
+
+```terraform
+terraform {
+  required_providers {
+    forgejo = {
+      source = "svalabs/forgejo"
+    }
+  }
+}
+
+variable "test_password" { sensitive = true }
+
+provider "forgejo" {
+  host = "http://localhost:3000"
+  // Due to an upstream limitation, one cannot create access tokens when authorized with an access token.
+  // Use basic-auth instead (FORGEJO_USERNAME / FORGEJO_PASSWORD environment variables).
+}
+
+resource "forgejo_user" "test_user" {
+  login    = "test_user"
+  email    = "test_user@localhost.localdomain"
+  password = var.test_password
+}
+
+resource "forgejo_personal_access_token" "test_token" {
+  user = forgejo_user.test_user.login
+  name = "test token"
+  scopes = [
+    "read:repository"
+  ]
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) Name of the personal access token. Changing this forces a new resource to be created.
+- `scopes` (Set of String) Scopes of the personal access token. Changing this forces a new resource to be created.
+- `user` (String) Name of the user. Changing this forces a new resource to be created.
+
+### Read-Only
+
+- `id` (Number) Numeric identifier of the personal access token.
+- `token` (String, Sensitive) The personal access token.
+- `token_last_eight` (String) Last eight characters of the personal access token.