From 167452875e98626b28f7383e531328892640c1d2 Mon Sep 17 00:00:00 2001
From: Dawa Ometto <d.l.a.ometto1@uu.nl>
Date: Wed, 16 Oct 2024 16:07:42 +0200
Subject: [PATCH] docs: add agisoft

---
 docs/index.md             |  2 ++
 docs/playbooks/agisoft.md | 25 +++++++++++++++++++++++++
 docs/roles/agisoft.md     | 22 ++++++++++++++++++++++
 3 files changed, 49 insertions(+)
 create mode 100644 docs/playbooks/agisoft.md
 create mode 100644 docs/roles/agisoft.md

diff --git a/docs/index.md b/docs/index.md
index de0624d1..778bf68e 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -52,6 +52,7 @@ status should be indicated in the description field of the catalog plugin item.
 
 ### Supported
 
+- [agisoft](playbooks/agisoft.md) install Agisoft Metashape
 - [aptly](playbooks/aptly.md)  serve apt repositories on the workspace
 - [ibridges](playbooks/ibridges.md)  userfriendly commandline client for iRODS
 - [icommands](playbooks/icommands.md)  commandline tools for iRODS data grid
@@ -86,6 +87,7 @@ The status of a role is either Experimental or Supported. Supported roles are su
 
 ### Supported
 
+- [agisoft](roles/agisoft.md) install Agisoft Metashape
 - [aptly_add](roles/aptly_add.md) add packages to Aptly repositories on the workspace
 - [default_group](roles/default_group.md) set desired groups as default for regular users
 - [desktop-file](roles/desktop_file.md)
diff --git a/docs/playbooks/agisoft.md b/docs/playbooks/agisoft.md
new file mode 100644
index 00000000..7cc6f59a
--- /dev/null
+++ b/docs/playbooks/agisoft.md
@@ -0,0 +1,25 @@
+# Playbook Agisoft
+[back to index](../index.md#Playbooks)
+
+## Summary
+Installs Agisoft Metashape, a tool for a photogrammetry pipeline.
+
+## Requirements
+
+- Debian/Ubuntu workspace with Desktop
+
+## Description
+
+Downloads and extracts the Metashape package, and installs the license file (see below).
+
+## Parameters
+
+- `license`: the contents of the Metashape license.
+
+## See also
+[agisoft role](../roles/agisoft.md)
+
+## History
+2022-24 Written by Jelle Treep and Dawa Ometto (Utrecht University)
+
+[back to index](../index.md#Playbooks)
diff --git a/docs/roles/agisoft.md b/docs/roles/agisoft.md
new file mode 100644
index 00000000..532bd5e4
--- /dev/null
+++ b/docs/roles/agisoft.md
@@ -0,0 +1,22 @@
+# Role Agisoft
+[back to index](../index.md#Playbooks)
+
+## Summary
+Installs Agisoft Metashape, a tool for a photogrammetry pipeline.
+
+## Requirements
+
+- Debian/Ubuntu workspace with Desktop
+
+## Description
+
+Downloads and extracts the Metashape package, and installs the license file (see below).
+
+## Variable
+
+- `license`: String. The contents of the Metashape license. Required.
+
+## History
+2022-24 Written by Jelle Treep and Dawa Ometto (Utrecht University)
+
+[back to index](../index.md#Playbooks)