# Create a new page

The next step after editing your first page is to create a new page! As you might recall, each Isomer Markdown file looks something like this:

```
---
title: FAQ
permalink: /faq/
---
Hello, Isomer! This is my very first edit!
```

The words between the 2 sets of triple dashes (---) is called the *front matter*. 

The front matter is where you configure the title and url for each page. Most pages will only have these 2 options (`title` and `permalink`), but some pages, like the [home page](https://app.gitbook.com/configuration/home/overview/) and [contact us page](https://app.gitbook.com/configuration/contact/overview/), have more.

{% hint style="info" %}
Permalink refers to the url of that particular page on your site. You will notice that permalink looks like this **`permalink: /my-page`**

Any pages on your site will have an URL that always starts with [www.your-site.gov.sg](http://www.your-site.gov.sg). Hence, we've excluded all the details before / and you only have to specify the **variable part of your site url**.
{% endhint %}

Now that you know about the front matter, let's get started creating your new page!

***Creating new page***

1. Head to the staging branch, and go into the `pages` folder.
2. Click the 'Add a file' button (it's to the upper right hand corner). Select 'Create a new file'
3.  Give a file a name, such as `myfirstpage.md`

{% hint style="info" %}
Note that your page is in Markdown format, hence the file name must end in `.md`. GitHub won't be able to automatically add that for you!
{% endhint %}

***Next, insert your content***

Now that you have named the file, you're free to add your content. 

You could copy and paste the Markdown above, or write your own! 

If your site already has a page with the permalink `/faq/`, remember to change the permalink to something else! One of the 2 pages will not be accessible if they have the same permalinks.

{% hint style="info" %}
Permalinks are the url of your page. On isomer, you only have to specify the variable part of your page URL since all the pages will start with the same domain.

For example [www.agency.gov.sg/my-pag\&#x65](http://www.agency.gov.sg/my-pag\&#x65);**. T**he permalink is **/my-page**
{% endhint %}

***Click the commit button to save the changes***

Once you're done, enter a commit message, make sure the 'Commit directly to the `staging` branch.' option is selected, and hit the green commit button. Just as before, your changes are now accessible on the staging site! (you might need to enter the permalink directly into the address bar)

##


---

# 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://v2.isomer.gov.sg/get-started/create-a-new-page.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.