Wikipedia:Teahouse/Design guidelines

Question forum »Host profiles »Guest profiles » Teahouse is built on some intentional guiding principles to give visitors a great experience.

• Learn more

jmcgnh, a Teahouse host

Experienced editor?
Become a host...

Teahouse research »

Design/Build Guidelines

Everyone is welcome to contribute to improving Teahouse!

Here are some principles to keep in mind to make sure your creations enhance the user experience with the spirit of the project.

Build for new editors

• Everyone is welcome in Teahouse, but new editors are the target audience. Consider how your new creation will affect new editors first.
• If it is better for experienced editors but makes things worse for new editors, it probably doesn't belong in Teahouse.

Keep it simple

• Teahouse works because it is simple, uncluttered and easy to use.
• User interaction should aim to match people's expectations of the internet today.
• Features which are more complex should only be host-facing.

Invite interaction

• Present clear, inviting calls to action. Each page should have a clear prompt like "Ask a question" or "Introduce yourself."
• Concise and friendly instructions work best.

Surface people and community

• To show visitors the human side of Wikipedia, highlight real people whenever possible.
• Guests and hosts have profiles, and every page features an active member of our community.
• Encourage participation by making it easy to tell someone when they did something well in a visible and fun way.

Show recent activity

• Teahouse shows guests a lively, active space that encourages them to join in.
• Display new things up front - we showcase active hosts and recent guests, and new questions appear at the top of the Q&A board.
• Make sure the space above the fold includes dynamic content, not just static text.

Play with the theme

• Teahouse’s design is inspired by the theme of a Japanese tea garden.
• We tend to use soft, warm colors and a natural theme to set a welcoming tone.
• Be playful. Teahouse is a place of asymmetry and whimsy, and riffing on the theme is welcome.

Make data-driven decisions

• Teahouse is based on research and experimentation to see what works best. If you have an idea, make it into an experiment.
• Start by asking questions like "what problem am I trying to solve?" and "what has past research shown works or doesn't work?"
• Test your hunches. Measure outcomes to learn if your change had a positive impact, and make decisions based on the results.

See also

• Wikipedia:Help Project/Guidelines