hackercouch/hackercouch

Hospitality for Hackers

hackercouch

HackerCouch is "Hospitality for Hackers". Here's how it goes:

• Fork this repo
• Add your own markdown file with your nick (perhaps twitter/github handle?) in the _couches directory
• You file a Pull Request on github
• Make sure the build passes
• Go check hackercouch.com the next time you are travelling.

See add.md for more detailed instructions.

The idea isn't new, it has been tried before as well. The reason we are trying this again is:

• The idea of a Fork->PR->Merge->Publish flow with almost zero effort
• Filing a pull request is a great filter for hackers
• hackercouch.com was available
• This comment by @sirupsen on HN

Development

See [HACKING.md]

Quickstart

You'll need to have Ruby and Bundler setup.

bundle install
bundle exec jekyll serve --watch

And open http://localhost:4000 in your browser.

Troubleshooting

• If your bundle fails due Nokogiri and you're on OSX, try running this first: xcode-select --install

Credits

• The original hackercouch project: jancborchardt/hackercouch
• remy/mit-license for the fork-PR-publish workflow.

Disclaimer

Our disclaimer policy is here.

LICENSE

This uses Jekyll collections and the base Jekyll theme. The very little code here is licensed under the MIT License. However, everything under the _couches directory is licensed under the CC0 license. If you file a PR to this repo, you agree to having your "couch information" available under this license.

The minimum required information is your nick, city and country code.

hackercouch's Issues

Profile images

Now I know that we shouldn’t reduce people to their looks, but profile pictures just help to quickly relate to people and also remember them.

We could simply get that info from the person’s Github profile (just like we can get the location btw).

Frameworks

Some points:

• I want to keep things super simple
• but at the same time damn good looking.
• It's also fun to learn new stuff and this sort of projects are excellent excuses.

Any preference framework to use for the new design (#7)?

Since the layout gives and sentiment to use Material Design and there are two major frameworks to do just that:

• http://www.material-ui.com/ (to use with React)
• https://material.angularjs.org/ (to use with Angular)
• http://mike1234.com/ember-material-design/ (to use with Ember)

Personally I'm very experienced with Angular, although I would love to learn more about React.

Any takers to work on new html/css/js? (I can definitely assist, maybe even do the job). I'd say let the most active person working on this to decide on framework, as long as it's something big enough and not some tiny experimental thing. ;-) Another priority would be that if way more people are familiar with framework X than Y, use the X.

Spread!

Let's collect a list of blogs / zines / other stuff where we can spread this once the new design is out (#7).

Zines

• https://gigaom.com
• http://www.theverge.com
• http://www.dailydot.com
• http://kernelmag.dailydot.com
• http://www.vice.com
• http://www.wired.com
• https://www.wired.de
• https://news.ycombinator.com
• http://techcrunch.com
• http://arstechnica.com
• http://www.hybe.com
• https://www.theinformation.com

Blogs

• http://framablog.org/ (in French)

Marking unavailability?

I actually got a request through Hackercouch! Unfortunately I am 10 time zones away from the location listed in my profile. Oops.

I propose we agree on a standard for marking a profile unavailable. Create a subdirectory? Symlinks like Apache? Or append ".unavailable" to the profile markdown file?

Add Request Management

It might be required to add some kind of layer between hosts and potential guests regarding communications. For a start maybe add a preferred contact method. On the long term, integrate with some messaging api ?

Other domains

FYI, I just registered hackercouch.org and hackercouch.net and 301 redirected them to here.

Take it as a donation. ;-)

If anyone wants access to domain control, let me know your NameCheap email or username here or write me [email protected]

Implement couch surfing profile reference field

So... we are all developers... but... some of us might want to know what were the experiences previously staying with that person, or perhaps even write the review, in case the experience was meaningful enough.

Link to other hospex networks

Add profile links to the most popular ones:

• Couchsurfing (https://www.couchsurfing.com/people/USERNAME)
• BeWelcome (http://www.bewelcome.org/members/USERNAME, note http)
• Warmshowers (https://www.warmshowers.org/user/NUMERIC-USER-ID)
• Trustroots (https://www.trustroots.org/profile/USERNAME)

http://ideas.trustroots.org/comparison-of-hospitality-exchange-platforms/

Icons:

• SVG for TR: https://github.com/Trustroots/trustroots/blob/master/modules/core/client/img/tree-white.svg
• PNG icons for the rest: https://github.com/Trustroots/trustroots/tree/master/modules/core/client/img/external

Add chat

@pierreozoux offered to host Rocket chat instance at his IndieHosters servers for free.

We already have #hackercouch at Freenode, but it's rather quiet due we're all on/off randomly at different timezones and IRC isn't as popular as it used to be in 90's. :-) It's also possible to link these two so it wouldn't matter if you'd use the channel via Rocket or IRC.

Could be hosted at chat.hackercouch.com

Whaddyathink?

---

Edit, Pierre already had an email exhange with @captn3m0 :

Nemo:
I think I'll add a link to freenode #hackercouch for now, and
maybe move to chat.hackercouch.com if it gets popular.

I'll hop on to the freenode channel soon.

Nemo:
I hadn't given much thought to chat itself. I could
point it sure, but even #hackercouch on freenode would
be fine, I think.

Pierre:
It is already created, but not much happening there lately

Nemo:
Are there any discussions on #hackercouch? There is
also the option of gitter.im (since we have a github
project).

Pierre:
Arf, no free software :) Rocket.Chat is :)

Pierre:
Hi!

We noticed you created hackercouch.com, nice :)

With Mikael, we are on the irc #hackercouch, and we
though that a webchat would be nice. I thought about
hosting rocket.chat, and we have yet to see how to
connect it to IRC.

Would you mind pointing chat.hackercouch.com to my
servers? (If you like the idea, I'll send you the
procedure)

All the best!

Pierre

Globe with meridians rendering

The globle unicode caracter is not rendered on my machine (linux+chrome+helvetica)

Do something about htmlproof link errors

- ./_site/couches/tonocm.html
  *  External link http://hcardenas.com/ failed: 500 No error
- ./_site/related.html
  *  External link http://www.adoptahacker.com/ failed: 523 No error
htmlproof 2.5.2 | Error:  HTML-Proofer found 2 failures!

https://travis-ci.org/hackercouch/hackercouch/builds/111392333

via #91

Faster edits via third-party hosting

Discussed on #42 previously. Thought I'd create a new issue.

Current idea is to have a gist: id field that is embedded in the HTML via JS.

Move to an organisation

Should we move this to an organisation?

Thoughts @captn3m0 @ppaeps @chettyarun @jancborchardt ?

Logo

Yo @captn3m0 :) since you used the concept of https://github.com/jancborchardt/hackercouch and push it forward, I’d be cool with you using the logo as well:

(SVG source in the repo)

Use jekyll plugins?

We are currently hosted on github-pages + Jekyll, where our build is generated by github itself on every push to gh-pages. However, we are restricted by this because github-pages doesn't allow custom plugins, except for a few: https://help.github.com/articles/using-jekyll-plugins-with-github-pages/

hackercouch.com shows 404

Fields missing in the JSON API

I am trying to build an alternative UI for it by making use of your JSON APIs and I'm seeing some discrepancies in the data returned by the JSON API and what's actually on the site.

1. The content field on https://hackercouch.com/couches.json returns the same string for all couches, to get the content specific to each hacker, I have to query their particular couch at /couches/<hackerName>

2. The social links on /couches.json and /couches/<hackerName> do not list all the social media handles

For example:
https://hackercouch.com/couches/NicolasFrancaX.html
and https://hackercouch.com/couches/NicolasFrancaX.json

as you can see, the facebook, twitter and website fields are missing from the API

Re-Designing HackerCouch

I want to take the task of re-designing the UI of HackerCouch. Will work on this mostly during my free time (weekends).

Tools I will use:

• Sketch
• Adobe Illustrator
• Invisionapp

I will post the invision project link by this next Sunday (28th November, 2015). Please do pitch in and give your feedback in the invisionapp comments section.

Nofollow

I personally don't like using rel=nofollow, but wanted to hear others opinion on the matter.

Map of locations

This is so rad! Would it be possible to tie in the locations to an embedded openstreetmap? I'd love to see where all these wonderful people are spatially, and something like that can help in route planning. Also, as more people add their locations, a list alone could get a bit unwieldy by itself.

contact jancborchardt/hackercouch forks

Wanted to put this out here to get some opinions before doing this:

Write a short mail to the various forks at https://github.com/jancborchardt/hackercouch/network and ask if they'd be interested in filing a PR to hackercouch.

The original upstream is mentioned as a inspiration on our about page, but the last activity on any on the forks was April 2016, so it might be worth migrating those here.

Thoughts @simison?

Add gravatar

It might be a good idea to add user images via gravatar?

Mobile first / responsive design

The website doesn’t work very well on small screens. There’s no reason it shouldn’t, cause it looks like you use a grid framework already. ;) Some simple media queries would be awesome.

Encourage PGP

I just put a note about my key in my "profile" section, but it would be great if it was a supported piece of metadata.

Add Gravatar

• Design discussion about Gravatars #7
• Duplicate of #32 but that thread sorta went to many directions, let's keep this purely on discussing tech solution for Gravatars.

---

Seems like there are two ways to go:

• Generate Gravatar hash at the client using https://github.com/webmodules/gravatar
• Use a plugin and compile the site before deployment using a rake task: http://blog.sorryapp.com/blogging-with-jekyll/2014/02/13/add-author-gravatars-to-your-jekyll-site.html

I'd go with the latter. Thoughts?

Developer setup instructions

The readme part at https://github.com/captn3m0/hackercouch#development assumes that everyone knows how Jekyll and Travis work or will read the docs on that just to run this site. ;)

Even for a semi-technical designer such as me it’s troublesome to get the site properly running. Do I need to jekyll serve or gem install something? Would be cool if we can say that in the section in the readme directly, just supplying the console commands.

Categorization

To quickly know what that specific person is up to and if one could work together with them, it would be cool to be able to list some tags in their profile (max 3 or 5 I would say).

This could be code-related like javascript, c++, python, css etc or also things like design, security, ci, …

Would be beneficial to be able to filter especially when this grows, but also to find your closer peergroups. What do you think?

Error: redirection forbidden

I'm trying to add my couch and I'm getting this error when run locally:

> $ bundle exec jekyll serve --watch --trace                                                                                                       ⬡ 10.14.1 [±akronix ●]
Configuration file: /home/akronix/workspace/hackercouch/_config.yml
            Source: /home/akronix/workspace/hackercouch
       Destination: /home/akronix/workspace/hackercouch/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
/usr/lib/ruby/2.3.0/open-uri.rb:225:in `open_loop': redirection forbidden: http://nominatim.openstreetmap.org/search/TUR/istanbul?format=json -> https://nominatim.openstreetmap.org/search/TUR/istanbul?format=json (RuntimeError)
	from /usr/lib/ruby/2.3.0/open-uri.rb:151:in `open_uri'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/open-uri-cached-0.0.5/lib/open-uri/cached.rb:10:in `open_uri'
	from /usr/lib/ruby/2.3.0/open-uri.rb:717:in `open'
	from /usr/lib/ruby/2.3.0/open-uri.rb:35:in `open'
	from /home/akronix/workspace/hackercouch/_plugins/to_geojson.rb:21:in `block in generate'
	from /home/akronix/workspace/hackercouch/_plugins/to_geojson.rb:16:in `each'
	from /home/akronix/workspace/hackercouch/_plugins/to_geojson.rb:16:in `generate'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/site.rb:175:in `block in generate'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/site.rb:173:in `each'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/site.rb:173:in `generate'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/site.rb:70:in `process'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/command.rb:28:in `process_site'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/commands/build.rb:65:in `build'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/commands/build.rb:36:in `process'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/commands/serve.rb:93:in `block in start'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/commands/serve.rb:93:in `each'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/commands/serve.rb:93:in `start'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/lib/jekyll/commands/serve.rb:75:in `block (2 levels) in init_with_program'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in `block in execute'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in `each'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in `execute'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/mercenary-0.3.6/lib/mercenary/program.rb:42:in `go'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/mercenary-0.3.6/lib/mercenary.rb:19:in `program'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/gems/jekyll-3.8.4/exe/jekyll:15:in `<top (required)>'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/bin/jekyll:23:in `load'
	from /home/akronix/workspace/hackercouch/vendor/bundle/ruby/2.3.0/bin/jekyll:23:in `<main>'

Add Reference System

As discussed on HN, a reference system would make both surfers and hosts feel more comfortable.

Is this project still maintained? 🙈

Is anyone still active here? Maybe it's time for a fork? Please show a sign of life 🙃
I PRed a few months ago to add my couch... No answer..
#201

Better tests

We can do so much more with travis:

1. Make sure that the couches are in _couches directory
2. Make sure all files have valid extensions
3. Anti-spam mechanisms via akismet. Run all the couch content for spam checks and fail the build if the spam scores are too high.
4. Validate the couch structure itself (required/optional fields)

Migrate to Jekyll v3

https://github.com/blog/2100-github-pages-now-faster-and-simpler-with-jekyll-3-0
https://jekyllrb.com/news/2015/10/26/jekyll-3-0-released/

It mostly works but with some bugs.

• Fix excerpts
• what else?

Kudos

I feel like the original would serve some kudos at readme, what do you think? :-)

https://github.com/jancborchardt/hackercouch