Authoring content
Every page within the developer portal is reprented by a markdown (*.md) file. For example, the content for this page is here. You can use Markdown to write the content and the developer portal will render it as HTML. For more information on how to use Markdown please check this page.
How do you get started
To get started you will need to create a .md file within the folder you want the page to live. All paths underneath the apps\devportal\data\markdown\pages
path are considered a page.
Let's say we want to create a page directly under the root of the site (developers.sitecore.com/hello-world).
To achieve this we can do two things:
- Create a hello-world.md file withing
apps\devportal\data\markdown\pages
- Create a folder called hello-world under
apps\devportal\data\markdown\pages
and create an index.md file within that folder.
Both options are good, the consideration you need to make is whether there is a need to host other pages underneath the path /hello-world/. If that is the case options 2 is most likely your best choice.
Please note that you can always start with a file hello-world.md
and change it later to /hello-world/index.md
when there is a need for more nested pages.