Please be clear and describe in your theme documentation (the README file included with your theme will help many users bypass any potential stumbling blocks):
- Specify exactly what your theme and template files are for.
- Stick to the naming convention in the standard theme hierarchy.
- Point out the shortcomings of your theme, if any.
- Write simple and clear comments, especially in complicated places, in templates and style files. Add comments in places where you’ve changed the default behavior of templates and stylesheets.
- If you have any special requirements that may include custom rewrite or change rules or the use of some additional, special templates, images or other files, please clearly indicate the user action steps that they must take to get your theme fully working.
- Try and test your theme in different browsers to catch at least some of the problems users might encounter.
- Include contact information (web page or email), if possible, for informational support and user questions.