# writing style

USE-IT’s style is like speaking to a foreign friend.&#x20;

USE-IT explains things the way they are – it’s that simple. No difficult words, no promotional blah blah, no exaggerations, no poetry. A golden rule: if the text does not sound natural when you read it aloud, it’s not a good USE-IT text.&#x20;

## Concrete

Our texts give information that young travellers need.&#x20;

The reader should know what it’s about. That sounds logical, but haven’t you sometimes read brochures that tell you how wonderful everything is without really giving information? If you write “cool bar with great music” or “open-minded place for all kinds of cultural events”, that might be true, but nobody knows what you mean. What is cool? What kind of music? Can you give an example of past events? What’s the typical crowd?&#x20;

It’s never easy to define a place, but nobody will go there anyway if you stick to the clichés.

<figure><img src="/files/Y6GLeodOhhrOBVGnuExV" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Chemnitz</em></p>

<figure><img src="/files/4ierPPP6LKYVrtXK7New" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Esch-sur-Alzette</em></p>

<figure><img src="/files/NVzWTCgb2R72wOk48faP" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Nantes</em></p>

## Visual

USE-IT texts include details that can actually be ‘seen’ when somebody reads the text, or ‘heard’, ‘smelled’, ‘tasted’ or ‘felt’.

<figure><img src="/files/8R1FyhI1tg0ywts0UlDw" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Ghent</em></p>

<figure><img src="/files/FlYFIJs5V7Rym0pFjBfE" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Nijmegen</em></p>

<figure><img src="/files/CnkAMeMsrJALbl7CpRuo" alt="" width="334"><figcaption></figcaption></figure>

<p align="center"><em>Graz</em></p>

## Informative

We do not make critical evaluations. It’s not about saying which place is good and which one sucks. Basically, if it sucks: don’t include it. Just give a clear description so that people who would like it will know. After all, who are you to decide? A metalhead expects something else from the city than a couple of lovers, who also expect something else than a group of five backpacking friends. Don’t give one- to five-star ratings, just inform clearly.&#x20;

<figure><img src="/files/ylGL3z9GmJmfSIbMdn7m" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Esch-sur-Alzette</em></p>

<figure><img src="/files/rPS40n4GkfE8X70q3Ppr" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Tromso</em></p>

<figure><img src="/files/eC4GRKrg5uH6i99Xk4I7" alt="" width="330"><figcaption></figcaption></figure>

<p align="center"><em>Graz</em></p>

## Practical

Don’t forget to include practical tips and be detailed about them. Taking a train isn’t hard as a local, but as a traveller, it can be challenging. Give as much practical info as you can.

<figure><img src="/files/fBM6UKlWforZ7B0ZUj55" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Chemnitz</em></p>

<figure><img src="/files/m9jaex2WEy7ftS2L08dv" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Prague</em></p>

<figure><img src="/files/gjDyGkVpcTiWbTvwtqbz" alt="" width="347"><figcaption></figcaption></figure>

<p align="center"><em>Nijmegen</em></p>

## Smart

USE-IT conveys local history and the stories behind places. Invite a historian, a sociologist and an architect to join your team! Our maps are more than simple fun, it’s about the character of your city, which is always grounded in history. Do your research well!&#x20;

Also, ask around. If you’re not gay, ask a gay friend. If you’re not into techno, ask a clubber. Etc.

<figure><img src="/files/q21d0WUoTgqjxwDM7cAh" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Ghent</em></p>

<figure><img src="/files/RsOmGAQ3aoHyUygnUPBv" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Warsaw</em></p>

<figure><img src="/files/hZUV1YId9YB2kxVcNy4C" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Prague</em></p>

## Young

USE-IT writes in a young style for a young audience. Don’t write in hiphop slang, but don’t be too formal either.

<figure><img src="/files/tFP0U2wYIfzWLoEgBUEU" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Esch-sur-Alzette</em></p>

<figure><img src="/files/uUIyEWcEmLIiQY2QZ1e1" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Nantes</em></p>

<figure><img src="/files/ome7VWPHEFIjz1AZRbKB" alt="" width="324"><figcaption></figcaption></figure>

<p align="center"><em>Warsaw</em></p>

## Funny and True

Keep in mind that the best joke is the one that is actually true. Stating a fun fact is better than inventing a silly joke. Also, don’t exaggerate. Is it really “gigantic”, “unbelievable” or “spectacular”? Really? These are words to use rarely. Before you know it, your text will sound like a tourist brochure.&#x20;

Just write as if you were speaking to a friend and your texts will feel more real. And please take it easy on the exclamation marks. (!!!!!!!!). They usually make jokes less funny and make facts less surprising. Or worse: they make you sound like the marketing department. Oh and: no smilies or emojis please. You don’t need them.

<figure><img src="/files/pIpQ03KJtTdo8dKdAbrH" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Brussels</em></p>

<figure><img src="/files/aDKZxSYlqI61T5W6sWXA" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Tromso</em></p>

<figure><img src="/files/E3rRFZKFiKW3KluR2mQS" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Tillburg</em></p>

## Up-to-date

USE-IT maps are updated every 18 months and include the talk-of-the-town. Which area is hipsterizing? Which bar burned down and started a crowdfunding campaign to rebuild? Many spots could never be described the same way on last year’s map or next year’s map.&#x20;

<figure><img src="/files/HtgCl79Qwlg4d7s4UrMj" alt="" width="334"><figcaption></figcaption></figure>

<p align="center"><em>Arhnem</em></p>

<figure><img src="/files/5brboHXYrMQejc0UgZNO" alt="" width="323"><figcaption></figcaption></figure>

<p align="center"><em>Warsaw</em></p>

<figure><img src="/files/71gFUp9J5wbtUUlLT22Q" alt="" width="375"><figcaption></figcaption></figure>

<p align="center"><em>Nantes</em></p>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://use-it.gitbook.io/use-it-wiki/editorial-style-guide/writing-style.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
