From Joomla! Documentation
Revision as of 20:06, 21 February 2008 by Chris Davenport
To make it easy to find the information you need, read the profiles below and choose the one that most accurately describes your current role. This will take you to an area where the documentation is organised according to the goals that you are most likely to require help with. There is a lot of overlap in the documentation for each of these roles; they are not mutually exclusive; so just choose one that seems to be nearest to your own role even if the fit is not exact.
- Content creators
- As a content creator you might have only a rudimentary knowledge of Joomla! Just sufficient for you to carry out your job of writing, assembling and publishing content on the website. You will need information about how to achieve specific goals associated with content creation starting with very basic information such as how to use a WYSIWYG editor. After becoming more proficient you might benefit from information about how to make use of some of the more advanced features that will streamline routine tasks.
- As an editor you will be responsible for reviewing the work of content creators, amending it where necessary.
- As a publisher you will be responsible for ensuring that content on your website is kept up-to-date and relevant to your target audience. You might commission content creators and liaise with editors to ensure consistency and good organisation of the content.
- As a website administrator you might be concerned about the visual appearance of a website but will pass responsibility for making changes and improvements to a web designer. Similarly, when changes to functionality are required you will contract a web developer to do the necessary work. As a website administrator you are responsible for the day-to-day operation and maintenance of the website. Activities might include ensuring that the site is properly backed up; managing user access; possibly installing extensions. You will also have responsibility for maintaining the security of the website.
- Web designers
- Web developers
- As a tester you are tasked with performing a predetermined sequence of operations in Joomla! and carefully observing and recording the results where they deviate from those expected. You may not necessarily be a developer, but you will probably be quite familiar with Joomla! itself.
- As a translator you are tasked with translating all the discrete strings found in the Joomla! front and back-ends and creating the necessary translation files. You may not be particularly familiar with Joomla! itself and you are unlikely to have any development experience. You will need to know how to use the translation debugging mode and how to assemble your translated strings into a translation file. You might also need to know how to package translation files into an installable translation pack.
- As a trainer you are tasked with producing and running training courses and you will need to create training materials to support your learners. You are likely to have a thorough working knowledge of the aspects of Joomla! that are the subject of your training courses, but you might need to refresh your knowledge from time to time, especially as new developments take place. You will want to have access to ready-made training materials that you can adapt for your specific circumstances.
- As a documentor you have the unenviable task of creating material for a wide range of readers from beginning users to advanced professional developers. You will need to know how to use various tools (such as this wiki) and you will need to read guidelines and other meta documents. You will probably need to update those documents over time too.