Contributing to the PrestaShop documentation
Just like PrestaShop itself, this documentation site (and its content) is open to everyone for suggestions, ideas and modifications!
All you need is to have your user-account validated by the administrators, and to follow the guidelines.
What we need
- Proofreaders. Mistakes happen! When pages of pages of documentation are being written, there is always a possibility that a typo might be typed, a word forgotten, or a homonym used when it should not be. Even proofreaders might miss mistakes, so the more the merrier! Being an open-source project, we like to keep Linus' Law in effect!
- Translators. Even though the PrestaShop tool is mostly written by French developers, we have decided to write our documentation primarily in English so as to stay open to as many foreign cultures as possible. Hence, we are always glad to welcome new translators for languages that are lacking documentation
- Writers.
Priorities
Our priority is to fully document the current stable version of PrestaShop. That means v1.4 for now, but comes v1.5, all the content from the 1.4 will be copied to a new folder, and will have to be updated. That will mean more proofreading, and more screen-captures to make. Yay!
Within that big priority are smaller priorities, namely:
- the Getting Started guide, where people will come first when discovering PrestaShop.
- the Updating PrestaShop guide, which will help users who cannot yet use the One-Click Update tool (only available since v1.4.4).
- and of course, the User Guide, which explains each of the PrestaShop tabs and functioning in detail. That's the biggest work, but one of the most useful there is, so it in much need to stay up-to-date.
Guidelines
Wiki tool
This website is powered by Confluence, which is an excellent wiki software from Atlassian – which, incidentally, also edits Jira, the software behind PrestaShop's Forge.
It is therefore highly advisable to get better acquainted with it's User Guide before editing a page or submitting anything for review, especially its wiki syntax (even though you can use a WYSIWYG editor by default) and how pages and sub-pages are handled. Do not hesitate to search the Confluence documentation for specific keywords.
Wiki syntax conventions
Just as for good code, wiki syntax must be written in a clear and coherent way in order for anyone to be able to edit it without interfering with each other. That means a few rules that need be respected: