How do we offer documentation?

I actually really like this idea. This could be a good way to make sure people making accounts are engaging with us consciously and purposefully from the get-go. Forcing new users to watch a video as part of the sign-up could, of course, deter people from completing the sign-up, but those people might be the ones we want deterred anyway… :thinking:


Continuing the discussion from Running/attending a regular meetup:

I love this idea! I had suggested handbook as a a general introduction to the platform and I generally think it would be so much nicer to have some handbooks, instead of faqs or a wiki. I think we’d also have the community that would love to contribute and collectively write some handbooks!?

Who else loves handbooks? :partying_face: :sunny:

1 Like

Handbooks can be great, but they are more effort to write, and can be daunting to read. I like the wiki format, which allows you to grow as needed, starting from a FAQ and ending in a handbook if you desire.


That’s also true! But in my experience, once you start a wiki, you always end up with lots of abandoned and half-made up pages. Or, in the case of faqs, a lot of links and redundancy.

I’d prefer to see a bit more focus with documentation, probably like a Wikibook. So it’s collaborative and open, but it’s also more focused on specific subjects.


I agree with this! I think a wiki could be very helpful, but we should probably limit who can edit it (or at least edit some pages). I share @nolo 's concerns about a sprawling wiki with half-completed and/or outdated pages. I’m not too familiar with Wikibook but it seems like the right direction. Hopefully we can make the interface a bit less clunky and more streamlined haha

1 Like

Not sure if I understood this correctly.
If is about the front page, that a person sees when they land on the website, from my perspective is very important to convey what is about. It can be a person that has no idea what the term “HospEx” means, a person that has never heard of Couchsurfing, BeWelcome, WarmShowers, HospitalityClub, You name it. I am talking a person that is totally new to all this. The website, through its main page must convey what is it about. As clearly as possible.
This is a good example which from my point of view (also because I am a member of it) does very well through its main page: On the main page is clearly written what the entire concept is about, what people that join can do thanks to it and what to expect.
If manages to convey clearly through its main page to everybody what is all about (not only to those that are already familiar to hospitality exchange) then will be a great achievement from the start because the people that will join will have a clear idea also about how to use it and is likely that they will then use it as WE mean it and so many “side-effects” will already be prevented from the very start.

Really like the approach on the Black Lives Matter site. They have a section Resources where several toolkits are presented and offered for download:

I think this approach helps a lot in having to define what are the central issues and actions and how to support good practice around them. As: organising events (or building local community in general), naming and handling harmful behaviour (or building and sustaining trust), expectations around hospitality (could call it a hospitality pledge)

1 Like

We mentioned the FAQ/guidelines in How do we build strong healthy communities?

Maybe let’s discuss what they should be like? And should it be one text, or maybe there could be formal guidelines/rules for do’s and don’ts and a more informal and detailed FAQ for tips and tricks?

I saw this FAQ in a Russian hitchhiking group and liked the tone and the examples, so thought I’d translate and share a part of it. I’m not suggesting, of course, to use it as it is, but maybe it could be a starting point for a discussion. Is it a good idea to have smth like this?

How to attract attention to your request and increase your chances of success?
To get answered and accepted, tell about yourself and your plans in detail.

  1. Mention the dates, number of people, purpose and duration of stay:
    :heavy_check_mark: Hi, I’m Vasya. I’m traveling with my friend Olya (profile link). We are two quiet students on the way from Murmansk to Baku. We’ll be in Tambov on the night from 8th to 9th November. Could you host us? We’d be very grateful for a chance to get some rest from hitchhiking.
    :heavy_check_mark: Hi! I’m going from Minsk to Baikal lake and writing about the trip in my blog (link). I’ll be in Krasnoyarsk around August 2nd and would love to see the city. Could you host me for 1 or 2 nights?
    :heavy_multiplication_x: Hello Moscow!!! Have a couch???

  2. Tell them what a nice guest you are
    :heavy_check_mark: I smoke outside, make awesome biriani, and don’t snore at night.
    :heavy_check_mark: I’ll bring sweets and tell you about my last year trip to West Africa over tea.
    :heavy_multiplication_x: I’m actually a nice fellow, but my empty profile is all I have for you.

  3. Carefully read the host’s profile and write a personal message. Show that you are interested in your host, not just in a free place to stay
    :heavy_check_mark: I checked out your blog and saw you were in Portugal last year. Me too! Would be cool to share our stories and lifehacks =)

And to the recent discussion on bedding and towels :joy:

It’s good to have a sleeping bag with you (and a towel! – cheers, Douglas Adams!). That way your host won’t have to look for bedding for you and wash it after you leave.
:heavy_check_mark: I have all the sleeping appliances with me and would be grateful for two square meters of your floor.
:heavy_multiplication_x: I just came from the Southern hemisphere and it’s summer there now. I hope you have a spare jacket, hat, and pants?
:heavy_multiplication_x: Ask “And where’s my bed and my towel?” the moment you entered the house.


At the moment this text shows up when writing a request: "Share your plans for the visit and include why you’re requesting to stay with this particular host”.

I like your suggestions about telling your host a little bit about themselves and the emphasis on reading host’s profile (and writing them a personal message). The biggest problem I have as a host are low quality generic requests that make me uninterested in hosting.

Here we go with towels again :smiley:
I would rather let hosts decide about the towels and sleeping bags themselves. I at some point had to “ban” towels from my household because I had recurring problems with them. Sometimes towels do not dry fast and if people travel with damp towels in their luggages or do not wash them regularly… well…they stink. When such towels are left in my bathroom if often makes me gag. I kid you not: in the past I used to have a house rule on my profile: “Guests are not allowed to use their own towels” :smiley: I would rather wash one more towel than have a stinky apartment. Like for real! I do not mind sleeping bags/own bedding (as long as they didn’t get stinky from the stinky towels :smiley: )

While some people require their guests to bring their own stuff it can be considered extremely rude for other people to not offer bedding to guests. “Check with your host if you need to bring a towel or a sleeping bag” would be better than “it’s good to bring sleeping bags/towels so your host won’t have to wash it after you leave”… I also actively offer my guests to do their own laundry at my place and the last thing I want my guests to feel is that extra laundry bothers me. It really does not. This can be different for every single host. However we shouldn’t assume that bringing bedding/towels is something what all hosts would be grateful for. If that would be the case, I am bringing my old house rule back :smiley: !

I still believe that sleeping bag/towel information should be directly on host’s profile on their Home page.


Haha no no, this one I just found funny. Not saying everyone should have a sleeping bag with them. Basically, I liked how this FAQ is informal, detailed and has examples, and was wondering if it’s a good idea to put smth like that. Of course Couchers is not a hitchhiking group, and needs different advice.

I also don’t suggest using Russian names and cities everywhere, just in case :)))

1 Like

Every case is particular. Every host and every traveler, and every trip are different (someone may have a sleeping bag when taking a long trip and not when taking a short one) so it would be nice to encourage people to not assume anything. Do not assume your surfer will have a towel. Do not assume your host will provide one. Specially if you are traveling to a different country where culture may differ.

I like the example @phaula showed. It’s friendly and super clear.


Yeah, I agree. It can be a more general point, including wifi, keys and so on.

If we are talking about content, here are a few other ideas.

After you get accepted

  1. Say thank you to everyone who answered. Exchange phone numbers with your host, ask their address and how to get there. Keep them updated if you’re getting late or changed your plans. If you were writing them a long time before your arrival, send another message 1-2 days before you are actually coming. If you are hitchhiking, it’s a good idea to send one more message when you get a ride to their city.

  2. It’s good to have a plan B – another host or an address of a hostel/hotel - just in case.

  3. It’s always nice to bring your host a souvenir from your city/country or some treats/sweets. However, if you are thinking of getting alcohol or meat, first ask how happy your host will be about that.

1 Like

We could also have hints for hosts. Like “once you accepted a request, provide your contact info, address and info on how to get there”

I have a pretty lengthy message I send all my surfers that includes:
-my adress
-link to Google map with location
-ways to get here from the airport, from bus to taxi with all the details about where to get them and how to pay for them (you need a card for the buss and the taxi is half price through an app) with links.
-safety basics till they get to my home (looking full gringo with all your luggage and taking selfies on your new iPhone on a train station may not be the best idea, duh)
-at what time I’ll be available to receive them.
-other tips about being here, like “visa is more widely accepted, mastercard not so much, so if you have the option bring a visa” or atms exchange rate and commission vs in person exchange rate because you basically get ripped off in the atms, that sort of things you don’t know till you arrive to a country and can make your life easier. You can include here any other rules you want to make clear about staying in your home too, like “don’t wear shoes inside” or “please keep your shoes on” (in my country most people keep them on, and it’s super weird for someone to take them off unless is invited to. I don’t mind tho, I’m barefoot all day.) Or “keep your towel close” :blush:

As said: mine it’s a lengthy message, but these are things I’ve learned over time that people don’t know and find useful, so I’ve compiled it and send it all.


I thought of it too!
And also another set of rules&hints for everyone, maybe? Like from no flirting to fill in your profile. Or a short list of strict rules that you need to accept when signing up and a list of tips&hints separately.

I guess hints for hosts could also have smth on how to tell a good guest from a bad one (like check references, host people who send good requests and have their profile filled in). And what hosts are supposed to do (I guess basically let people sleep at their place and spend some time with them) and what’s sweet to do but is totally ok not to (show around the city, cook meals… provide towels :joy:).

And for surfers, I guess, it’s good to also have “how to choose a good host”, “when to start sending requests” and “while staying” parts.


I like this idea - on that note, we can also urge hosts to (IF AND ONLY IF they have the mental capacity and patience at the time) optionally provide constructive feedback to surfers who had a bad request, that way users could gradually and organically educate each other and build a better community. We could even urge users to have some “template replies” that point surfers towards the FAQ page, if they did not provide a quality request. I know @Jesse did that on Couchsurfing a lot. :slight_smile:

1 Like

Maybe it’s better if the system does that? If that’s possible. Like if don’t get accepted, you get a note - we see your requests don’t get accepted, the possible reasons are … (empty profile, bad request, etc), see more in the FAQ (link). It’s very sweet of Jesse and other people to explain this stuff to people, but I don’t think the platform should urge you to do that.


Been there, tried that on CouchSurfing! Sometimes it worked and people were grateful for constructive feedback, sometimes it didn’t work at all- a lot of people do not like unsolicited advices.

I usually only gave feedback if people specifically asked for it and when I felt that they are not going to get upset about it. But sometimes it’s difficult to predict that. Like when I got a generic copy and paste request on CS that I ended up declining and the guy asked me (very friendly) why am I declining etc. so I wanted to be helpful and replied that the message I got from him was copy and paste and that I unfortunately do not accept those, I gave him recommendations on what to improve and wished him a nice stay in my city. He followed up with a message explaining that copy and paste requests always worked for him so he sees no reason to write personalized requests… moreover I got a negative reference “Too rude too blunt too self absorbed”. No good deeds go unpunished :smiley:

I don’t think I will be the one educating surfers anymore (even if I have the mental capacity and patience) simply for the fact that not every surfer appreciates it. Now, when people ask me for the reasons why I decline or ask for feedback I simply do not reply at all. Sadly, it’s easier for me this way than sending link to “How to write a couch request etc.” and other written advices I used to give in the past.

I agree with Phaula, I would rather if the constructive feedback came from the system. There could be YES NO option coming with the request: “Do you find this message/profile to be in the spirit of Couchers?”. If the person gets a lot of NO feedbacks, they could get a system message with possible reasons that @phaula suggested that would in the end help them figure out what to improve- fill out profile, add profile picture, read other people’s profiles, write better requests etc. so hosts do not have to deal with it.


i’ve just got a template decline message for copypastes hehe, but yeah i referece the “Howto write a couch request site” although the link is now offline, haven’t bothered to change fix it yet

this is an automated response designed for those that didn't state any good reason 
as to why they wanted to surf at my place instead of somewhere else that or just 
didn't follow any of my guidelines, read my profile (again) and if you really want to 
surf at my place try writing something different (read the IMPORTANT lines at the 
top of my profile)

if you still don't know what to write or think you did well and don't understand why 
i decline you, try reading this page:
1 Like

This actually awakened something in my mind when it comes to profiles/requests. It’s very possible that these kinds of information can be something that contributes to the reference or community score. One sentence requests, whether declined or not, can reflect a lot in how communication is of the host/surfer. Just a thought.


Interesting but where is the guarantee it won’t backfire on you? Imagine the situation that you: a host have power to lower surfer’s community score because you didn’t like their request. Now imagine that surfers can do the same- lower your community score because you rejected them.

Whatever the score is going to be about I hope it will only reflect real life- hosted/surfed/met experiences.