Chore/update data docs

[adurkan-amido]

Creating Draft PR to be able to add comments when testing.

📲 What

A description of the change.

🤔 Why

Why it's needed, background context.

🛠 How

More in-depth discussion of the change or implementation.

👀 Evidence

Screenshots / external resources / links / etc.
Link to documentation updated with changes impacted in the PR.

🕵️ How to test

Notes on how a reviewer can test the changes, e.g. how to run the tests.

✅ Acceptance criteria Checklist

• Code peer reviewed?
• Documentation has been updated to reflect the changes?
• Passing all automated tests, including a successful deployment?
• Passing any exploratory testing?
• Rebased/merged with latest changes from development and re-tested?
• Meeting the Coding Standards?

[adurkan-amido]

Our file was named scaffold.yml

[adurkan-amido]

You can only do the rename after the initial commit.

[adurkan-amido]

Suggested change

	Update the credentials file with the Azure Service Principal and the Azure DevOps PAT.
	Update the generated credentials file (located in the project in the `local` directory) with the Azure Service Principal and the Azure DevOps PAT.

[adurkan-amido]

Getting an error at this step:

> source local/envfile_networking.bash
dirname: invalid option -- 'b'
Try 'dirname --help' for more information.
-bash: /credentials.bash: No such file or directory

Updating the first line in the envfiles to just . local/credentials.bash seems to fix it.

[adurkan-amido]

Suggested change

	- [Git repository](./requirements_data_azure#git-repository)
	- [Azure Subscription](./requirements_data_azure#azure-subscription)
	- Service Principal with Contributor role on the above subscription
	- [Azure DevOps tenant](./requirements_data_azure#cicd---azure-devops)
	- Azure DevOps Personal Access Token (PAT)
	- [Tools](./requirements_data_azure#infrastructure-deployment)
	- Docker Engine
	- Taskctl
	- [Git repository](./requirements_data_azure#git-repository)
	- [Azure Subscription](./requirements_data_azure#azure-subscription)
	- Storage container for Terraform state
	- Service Principal with Contributor role on the above subscription
	- [Azure DevOps project](./requirements_data_azure#cicd---azure-devops)
	- Azure DevOps Personal Access Token (PAT)
	- [Tools](./requirements_data_azure#infrastructure-deployment)
	- Docker Engine
	- Taskctl

[adurkan-amido]

When I run taskctl infra:plan I get this error:

│ Error: the url of the Azure DevOps is required
│
│   with provider["registry.terraform.io/microsoft/azuredevops"],
│   on providers.tf line 21, in provider "azuredevops":
│   21: provider "azuredevops" {

I think this could be because in the envfile, these are empty:

# URL of the ADO organisation to target
 export TF_VAR_ado_org_url=""

# Name of the project in which the variable group will be created
 export TF_VAR_ado_project_id=""

If these need to be populated manually, it needs adding into the docs.

[adurkan-amido]

When I run taskctl infrastructure I get this error:

Attempting to select or create workspace: nonprod
DEBUG: terraform workspace select -or-create=true nonprod
terraform workspace select -or-create=true nonprod
Permitted exit codes: 0
Exit code: 0
/usr/bin/chown: missing operand after ‘/workspace/.taskctl/deploy/terraform/networking/.terraform’
Try '/usr/bin/chown --help' for more information.
/usr/bin/chgrp: missing operand after ‘/workspace/.taskctl/deploy/terraform/networking/.terraform’
Try '/usr/bin/chgrp --help' for more information.
Error: pipeline infrastructure failed: exit status 1
FATA[0006] pipeline infrastructure failed: exit status 1

[RichardSlater]

Updated this branch with changes from 2025-06-11 (Update Docusaurus to 3.8)