# Improving the documentation
Handlebars is an open-source project. There is no "documentation department" that keeps the docs up-to-date. This documentation site requires your help to be a good and helpful site.
Release notes (opens new window)
Issues with label 'docs-needed' (opens new window)
The old Handlebars website (opens new window)
The following sections should help you help us improve the documentation.
# How do I submit contributions?
This site is hosted on Github (opens new window) and rendered with VuePress (opens new window)
- Please create a pull requests (opens new window) for any change that you would like to see on the page.
- If your change only affects the contents of a single page, you can simply click the link
Propose a change to this page!at the bottom of this page (see Editing files in another user's repository (opens new window)) for details. - For more complex changes (styling, multiple pages, new pages, fixing build problems), you should fork the repository (opens new window) and submit a pull request when you are done. The CONTRIBUTING.md page in the repo (opens new window) contains more information about. This approach allows you to use a dev-server and preview your changes before submitting them.
# How do I write content?
The documentation is written in Markdown and rendered with VuePress (opens new window). VuePress uses the
markdown-it package to render markdown. markdown-it implements the CommonMark dialect.
This means that you can use syntax described in these sources:
- CommonMark help (opens new window)
- syntax extensions added by markdown-it (opens new window)
- syntax extensions added by VuePress (opens new window)
In addition to all those extensions, this site adds some custom Vue-components that can be embedded in source files.
# How should I behave?
DANGER
Respect intellectual property: Please only submit texts and other media if you have created it yourself or if you have copied it from handlebarsjs.com (opens new window). There are many blog posts about Handlebars, but the text from these posts is intellectual property of their authors.
License: By submitting content, you agree that it is published on this site under the license of this site.
Code of conduct: Please be respectful to others and avoid sexualized or coarse language.
# What can I contribute?
- Look for issues labeled as docs-needed (opens new window) in the handlebars.js (opens new window)-repository. Those are issues that describe something that should be documented.
- Propose and submit new content. If you are unsure about your proposal, you can create an issue before submitting a pull-request. This might save you from wasting time.
- Improve existing content. You can propose changes to the navigation, fix typos, improve language and correct wrong content.
- Fix CSS-styling issues. The styling on this page is far from perfect. If you feel like improving it, please go ahead. For larger changes, please get in touch by opening an issue.