# [Create a new Learning Path](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/write-1-init/)

## In this learning path

- [Introduction](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/)
- [Learning Path basics](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/overview/)
- [Learning Path setup](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/setup/)
- [Create a new Learning Path](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/write-1-init/)
- [Modify Learning Path metadata](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/write-2-metadata/)
- [Contribute](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/contribute/)
- [Format content](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/appendix-1-formatting/)
- [Writing style guide](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/appendix-2-writing-style/)
- [Test your code](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/appendix-3-test/)
- [Maintaining the content](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/appendix-4-maintain/)
- [Common questions](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/questions/)
- [Troubleshooting](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/appendix-5-troubleshooting/)
- [Next Steps](https://learn.arm.com/learning-paths/cross-platform/_example-learning-path/_next-steps/)

## Add a new Learning Path
To add a new Learning Path, first decide the appropriate category. There are 6 categories into which you can contribute content:

- servers-and-cloud-computing
- laptops-and-desktops
- embedded-and-microcontrollers
- iot
- mobile-graphics-and-gaming
- automotive

**Note:**  
Place your Learning Path in the category closest to the environment where the software runs. The tags on the [front page of the website](/) help explain the categories. Feel free to ask on GitHub if you are unsure which category best matches your Learning Path.

You can also add a new install guide. Install guides are short descriptions providing commonly used information to install tools and software. Install guides are easy to reference from multiple Learning Paths and avoid repetition. Upcoming section will provide details to create a new install guide. Refer to the [existing install guides](https://learn.arm.com/install-guides) to see what is available.

### Create a new Learning Path
This section creates a new Learning Path. Refer to the next section to create a new install guide.

Start creating your Learning Path from the template provided using a straightforward one-line command. For example, to create a new Learning Path with the directory name `my-new-learning-path` under the `embedded-and-microcontrollers` category, run the following command from the root directory of this project:

```bash
hugo new --kind learning-path learning-paths/embedded-and-microcontrollers/my-new-learning-path
```

Result: The following markdown files are added to the `my-new-learning-path` directory:

| Files            | Details                                                                                                                                                                                                                   |
|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| _index.md        | This file contains the title, target audience, and tagging metadata for your new Learning Path. These are displayed when clicking on the `Introduction` section in the vertical menu on the left.                       |
| how-to-1.md      | This file contains the how-to content for the Learning Path. Create multiple how-to pages to segment stages within your Learning Path. Each `how-to-N.md` file represents another distinct stage in your learning Path. |
| example-picture.png | (optional) Pictures and screenshots can be included in this directory to appear in your Learning Path. Images can also be referenced as web links if you prefer.                                                          |
| _next_steps.md   | DO NOT edit this file, it acts as a static placeholder only.                                                                                                                                                          |

### Order the content within the Learning Path
Each markdown file has a field called `weight`. Use this field to order the way your content is displayed. The content with the lowest weight is displayed first.

The _index.md is first with `weight: 1`. You should start with `weight: 2` for your next page (`how-to-1.md`) and `weight: 3` for the page you want displayed after that.

### Create a new install guide
Create a new install guide by copying an existing file in the `content/install-guides` directory and modifying the contents.

For example, copy the AWS CLI install guide to create your new install guide.

```bash
cp content/install-guides/aws-cli.md content/install-guides/my-new-install-guide.md
```

Use a text editor to open `my-new-install-guide.md` and change the title of the new install guide to your desired title.

The new install guide will be visible in the install guide category when you run `hugo server` in the next section. You can continue to edit the file to create your new install guide.

### View the new Learning Path
You can verify you have correctly copied the template by viewing the new Learning Path.

1. Run Hugo server

If Hugo is not already running start it.

```bash
hugo server
```

1. View the Learning Path you just created in your browser by opening [http://localhost:1313/learning-paths/embedded-and-microcontrollers/my-new-learning-path](http://localhost:1313/learning-paths/embedded-and-microcontrollers/my-new-learning-path)

2. Refer to the appendix listed below for content formatting and style guidance

You should take a few minutes to understand how to format your Learning Path and review the writing style guide to learn how to best write for the target audience.

- [Appendix: Format content](/learning-paths/cross-platform/_example-learning-path/appendix-1-formatting/)
- [Appendix: Writing style guide](/learning-paths/cross-platform/_example-learning-path/appendix-2-writing-style/)

1. Start modifying the Learning Path

You can now start modifying the markdown files using your text editor to write content for your new Learning Path.

Check the results in the browser to see how they look.