# Editing the handbook

## **Who can edit the handbook**

At the moment, the handbook can only be edited by Bristol Cable staff who have accounts. 

Please check with the Tech Co-ordinator before changing the structure of the handbook in any drastic way. 

## **How to edit a page**

### Get permission

For **typos and small errors**, it doesn't matter whose page it is - if you see something that needs correcting, go ahead! For bigger changes, that **change the meaning of the content more substantially,** check who is in charge of the page. If it's your circle then great, go ahead. 

If it's another circle, either ask them to make the change or get their permission to make it yourself. 

### Editing a page

Once you've got permission to edit a page, login and you should be able to edit. 

See Github's guide to editing [here](https://docs.gitbook.com/content-editor/overview). It's a good place to start.

**But the quick version is** - you can edit by clicking on the page. <mark style="color:purple;">Save your changes in draft form by clicking the green</mark> <mark style="color:purple;"></mark><mark style="color:purple;">**Save**</mark> <mark style="color:purple;"></mark><mark style="color:purple;">button on the left hand dashboard panel.</mark> You can name your changes so that you can come back to this draft. Once you're ready for the content to be made public then click the blue **merge** button.&#x20;

### Undoing mistakes

If you make a mistake, you can use the classic CTRL+Z shortcut to undo it. Or for bigger, saved mistakes, <mark style="color:purple;">check the activities tab in the furthest lefthand dark dashboard.</mark> You can see all previous versions of the handbook in this tab.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://handbook.thebristolcable.org/guide-to-editing-the-handbook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.