So, the idea would be to show gitlab to... people that already use gitlab? I think this way captures a market of people who are familiar with github who want to transition to gitlab. The nature of the guide is such that we're relying on the guide writer to be knowledgeable about gitlab, but by being hosted on github we're also shown they're knowledgeable (enough) about github.

Do people just randomly browse GitHub search for tutorials on how to use GitLab? That makes no sense. I'm pretty sure all the traffic that page is getting will be from news aggregators like HN, or from search engines, both of which don't care where it's hosted. It makes more sense to have it on GitLab so you're actually seeing the features being presented without having to go to a whole other site, and to show the site can handle the traffic / use-case.

Well, then why does it even matter that it's hosted on GitHub? If GitHub is being used as little more than a public hosting page that people will directly link to, then what benefit is there from being on GitLab?

To be more specific about what I was saying earlier: the differences in form factor, features, layout, etc. are all going to be unfamiliar to those who don't know GitLab--so, presenting them a migration guide to GitLab from GitHub that's also already hosted on GitHub, with the layout and all the features they're already familiar with, is going to have a higher conversion factor than otherwise. It's not necessary that they randomly browse to this guide. Guides work because there's a smooth transition between the easy/familiar and the objective. By starting on the familiar, the guide is more inviting to follow.

I guess I can see it both ways, but in my mind, if GitLab's UI is too confusing for a new user to even navigate, then maybe it isn't good enough to migrate to. I do agree that familiarity with GitHub helps, but by that logic, a normal blog (maybe on Medium) would've been even better. The fact that it's formatted as a git repo (which is honestly sub-optimal for a tutorial), yet not hosted on GitLab, just felt strange.

If the guide is on Gitlab, then you're in the Gitlab interface and immediately click around and open new tabs of the different things.

The README page should be obvious to any user, regardless of background. Sorry, but your argument doesn't make much sense.

My argument isn't that the README won't be easily readable between git interfaces. My argument is mostly a) I expect that conversion rates will be higher going from GH -> GL if the guide is hosted on GH, and b) the guide is already hosted on GH, so, therefore c) you'll need a much better reason than a specious argument about dogfooding to compel a change.

I mean, it's just a git directory with a README.md--it's not like it can't be both places, but the argument from dogfooding I don't think is a good one.

Getting the word out is what the HN post is for. That's orthogonal to where the content is hosted. In addition to the confidence comment, I think it's kind of shitty.

Agreed and now all the discussion on HN is about _where_ it's hosted, instead of the content itself. It's the first thing everyone noticed. My guess is they did this on purpose just to generate controversy

GitLab do all their development in the open on their own platform (https://gitlab.com/gitlab-org/gitlab-ce), I think there is enough dog food being eaten.

It doesn't make much sense to put a thing for people who don't use GitLab on the thing they don't use.

This was obviously made on purpose. Hosting a readme isn't really a testament to 'eating your own dog food' anyway.

What remains is whether you appreciate the PR stunt (using a competitor to market yourself), which is another issue entirely.

> What remains is whether you appreciate the PR stunt (using a competitor to market yourself), which is another issue entirely.

To quote from that readme: "Secondly, I am not affiliated with Gitlab."

Thanks, I had missed that.

Thank you for understanding ;)

Possible reasons to post it on Github: 272 followers and better search engine performance.

Came here to say the same thing. I already have moved a project over to GitLab so it feels like the same thing (but open source, and I can self host). But if the above was hosted on Gitlab people would see it has the same features (and private repos and free DevOps integration on a shared server).

The third paragraph:

> Secondly, I am not affiliated with Gitlab.

So this would be no “own” dog food at all.

The author explicitly writes:

> Secondly, I am not affiliated with Gitlab.

Confidence in what? The accuracy of the article?

Confidence in GitLab.

Upvoted because of the irony that OP hosted this on GitHub. Good fun :-D

I don't see the irony. If there is a group of people you want to talk to, you go where they are.

Just pointing out something that made me smile. I suppose any time someone is marketing or building a new/underdog platform, some ironic elements will be present. Like Stallman using Unix machines to develop the GNU toolchain. :-)

I understand why people make fun of this. It is obviously ironic. But I am happy most of the comments replying to yours speak out my intent. I neither "accidentally" put it on Github, nor make use of Github unethically to promote Gitlab.

Here is a PowerPoint about how to use Keynote.

That makes perfect sense for getting extant Powerpoint users to consider moving to Keynote.