Github For Everything

http://wiredcraft.com/posts/2013/09/18/github-for-everything.html

by hunvreus • 13 years ago

100 63 13 years ago

Although it's nice that everything is in one place I don't think Github would be my first choice. It's made primarily for managing code and everything surrounding that. I do think the issue tracking translates very well over to "real life" issues.

Why are the legal documents not on GitHub though? That would be perfect for github.

hunvreus4• 13 years ago

We've actually stored legal documents on Github in the past (think contracts, proposals, employee handbook, invoices...) as Markdown files. It felt very strange though to collaborate around files through Git. The `PULL > COMMIT > PUSH` workflow works well for a lot of things, not necessarily well when you're preparing a contract.

We've actually built a tool around Dropbox for that very use case. Happy to share it here when it's ready end of this month.

evolve2k• 13 years ago

I actually imagine github would work quite well for this if office users edited directly from the github website.

gcv2• 13 years ago

You made your non-tech staff write Markdown files? How did that go? Also, about contracts — .doc/.docx is lingua franca. How did you deal with collaborating with the rest of the world?

kaeawc• 13 years ago

Please do share, would be interested to see it.

kassner3• 13 years ago

It great, but I concern about exporting data out from GitHub for whatever a reason. Is there a backup anything or we just have to dig data out from API?

thomaslangston2• 13 years ago

Every repo can be cloned down as normal. ~~I'm not certain about the issue tracking.~~

Edit: according to a quick Google search issues can be exported in JSON format.

hunvreus4• 13 years ago

Issues are disposable data, it has an expiration date. Once you closed an issue, there's little value in it. Most of the valuable data ends up in the Wiki (or in code), and Wikis are actually Git repositories. You can't make it easier to backup.

Wanna try it? Take any repository, for example Hubot: https://github.com/github/hubot. Now go ahead and run:

git clone https://github.com/github/hubot.wiki.git

kassner3• 13 years ago

I didn't know the ".wiki" notation for downloading it. Thanks!

kassner3• 13 years ago

Issues are an important part of a product/library that is evolving. If you loose an edge case bug, you could take months to face it again.

bergie• 13 years ago

You could also use the GitHub Issue API http://developer.github.com/v3/issues/ to backup the issue data

dkuebric• 13 years ago

This isn't what I thought it would be. I think "Github for everything" is something everyone should be looking for in their lives. Version control is useful for so many things.

I think the understand this already though. With the release of stuff like 3d diffs now it's the "GitHub of CAD", I could imagine a useful future for the "GitHub of legal documents", "GitHub of _____"....

__--__2• 13 years ago

While I appreciate the sentiment that version control is very useful, I'm loathe to put all of my data in the hands of a US based company again. Went down that road once with Google. Never again. I think "Git for everything" should be the mantra, but I realize the unix philosophy behind git probably makes that unlikely.

I think it would be cool to set up a 'github' 'p2p protocol' where if you sign up with one server you can access projects from any other server following the protocol. For example, I run my own 'github' instance just for me on my personal server. A company can host an instance on their servers and, if they implement the protocol, I can use my instance to submit a pull request on a repository they host. Complete interoperability.

drdaeman• 13 years ago

I think it would be cool to set up a 'github' 'p2p protocol'

I believe that one is called Git, with HTTP or SSH and SMTP as helper transports.

(In particular, pull requests are done with `git format-patch` and `git send-email`)

icebraining3• 13 years ago

For example, I run my own 'github' instance just for me on my personal server. A company can host an instance on their servers and, if they implement the protocol, I can use my instance to submit a pull request on a repository they host.

Yeah, and that'd be really nice since you could see all the issues you submitted to different repositories/companies in a single view, which should receive updates from the remote tracker.

samatman• 13 years ago

You're looking for this:

https://code.google.com/p/gittorrent/

Frustratingly, it has been dead in the water for years. It strikes me as a crucial piece of technology.

thomaslangston2• 13 years ago

I expect with a few custom front end UIs, even the poor fits could at least use github as a backing store. This could give other company tools one data layer to inspect.

6cxs2hd6• 13 years ago

Although maybe this blog post was already in the pipeline, unfortunate juxtaposition with yesterday's GitHub outage.

Although I truly do love GitHub, it's not unconditional love. My love's uptime closely tracks GitHub's.

fuckyoutoo• 13 years ago

Your wife wishes github was more reliable.

kyzyl2• 13 years ago

Protip: In almost no circumstances is it a good idea to make comments about someone's spouse. Much less on a professional forum, and certainly not on HN. Regardless of the intent, the potential for misunderstandings, over reactions, and incorrect inferences is great, meanwhile such comments almost never add any meaning to the discussion.

topac• 13 years ago

Everyone love and use wikipedia but i do not see 10k posts per day saying that wikipedia is the new god.

solistice• 13 years ago

You're just a couple of years late.

davexunit4• 13 years ago

I think depending upon a single, proprietary web service for everything is foolish. When Github is down, you're out of luck. If Github changes in a way you don't like, you're out of luck.

Goopplesoft• 13 years ago

I dont think diversification would do much better. Most big github features are probably handled by separate teams and function somewhat independent of each other as well. But downtime could be a big issue although Github has been generally good at it (https://status.github.com/graphs/past_month) People also rely on github git repos for deployment (e.g. in requirements.txt) so their work would likely survive standard levels of downtime.

joeblau• 13 years ago

GitHub offers and enterprise offering that you can host yourself. It's no better/worse than hosting your own version of JIRA, Confluence, and a git repository. That way you're not 100% dependent on github.com actually being up. As far as changes, you're right, but the changes are true with any product. At my last company, we did a JIRA upgrade which ended up being a nightmare for process because lots of things changed and were configured incorrectly. I guess I'm trying to say that what you're saying is true for any SaaS product you use and doesn't take away from trying to use GitHub, maybe not necessarily github.com, to run everything.

davexunit4• 13 years ago

As far as changes, you're right, but the changes are true with any product.

This is true, but only with proprietary software are they unfixable.

rohamg• 13 years ago

Welcome to the internet! You must be new here :)

Jokes aside, using any proprietary web service has the exact same downside. And yet here we all are using Google Apps, Dropbox, GitHub, HipChat, Intercom, and dozens of others. As a team, we found additional web services add exponentially increasing complexity; we eventually needed a platform to keep track of all the platforms we were using. So we back-tracked and went the same route as the Wiredcraft guys, centralizing everything into GitHub.

As a community, instead of advocating turning the clock back (which will never happen: the toothpaste has exited the tube), we should explore ways to satisfy security & reliability concerns while maintaining convenience. Also, you can self-host GitHub.

abritishguy2• 13 years ago

I agree with what you are saying, but as far as reliability goes github sucks badly and until it gets much much more reliable I think using it for "everything" isn't really viable for most businesses (unless they have enterprise). I might not have any more redundancy with Google Apps, but I am yet to be affected by an outage.

chriswarbo2• 13 years ago

Erm, I think you're the one who's new here. Proprietary Web services and walled gardens are a recent thing. FTP, email, HTTP, etc. are all open systems.

Of course some companies did try to flog proprietary services and protocols decades ago too, but the users were clued up enough to avoid them and let them die.

davexunit4• 13 years ago

Yes, you are correct that using any proprietary web service has the same downsides, which is why I have taken it upon myself to avoid as many of them as possible and support free, decentralized alternatives.

I do use github to host my source code currently, but it would be trivial for me to move to a free service such as gitorious, or a gitlab instance, or my own server running cgit or gitweb.

What do you mean you can self-host GitHub? GitHub is not free software.

chriswarbo2• 13 years ago

Exactly. The entire reason Git was created is because a proprietary version control platform (BitKeeper) was given too much trust and power over Free Software projects, which it inevitably abused.

The whole point of Git is that you don't have to surrender control. GitHub is just another BitKeeper. If you really want a Web interface there's Gitorious (which has been around longer than GitHub) and GitLab.

The number of Git-backed Wikis, bug trackers, filesystems, etc. is huge too, judging by the New Packages I see in aptitude every few weeks.

zalew2• 13 years ago

If you really want a Web interface there's Gitorious (which has been around longer than GitHub) and GitLab.

and recently https://rhodecode.com/ which kinda looks like an opensource version of BitBucket.

fraserxv• 13 years ago

Like this way of getting things done. Geeky! I may translate the post into Chinese later.

mck-• 13 years ago

This is exactly what we do at our team too -- we're developer centric and as developers, we love using Github and Github issues (+ pull-requests) for everything (including PM and HR)

One thing we do miss are certain features from Trello-like tools that give a nice overview of your issues and facilitate PM, so we built a Chrome/FF extension to fill in those gaps (http://zenhub.io)

Disclaimer: I work at Axiom Zen

dencold• 13 years ago

One thing I wish Github would do is allow for a more granular permission structure. It would be fantastic if we could allow people without github accounts do things like submit issues, or allow certain users (e.g. non-technical staff) only have access to the wiki and issue tracker.

Right now the permissions are centered around what you can do with repositories, it's very developer-centric. I think there is a lot that GitHub could do here to expand their service to be more applicable to an entire organization.

hunvreus4• 13 years ago

We've been using Huboard recently, but I'm definitely in terested in seeing how Zenhub compares to it. How are you guys going to monetize this?

abritishguy2• 13 years ago

Github goes down far too frequently to consider using the non-enterprise version for everything.

The realtime collaboration on Google docs is also mega useful for weekly meetings and something that Github's wikis doesn't match.

pearjuice• 13 years ago

I'm still bracing myself for the Github for Writers; http://madebyloren.com/github-for-writers

ideadude• 13 years ago

I'm writing a book for O'Reilly and we use their Atlas tool which stores everything in a git repository. Pretty cool, especially for technical books.

It's open to the public [oops, I lied. It's private beta] in beta: http://atlas.labs.oreilly.com/

breckinloggins• 13 years ago

Idea: Github should allow "plugin repositories" that can be shared or private.

The first iteration would have some way to provide file type viewers. A file under filetype/viewer.js.js would replace github's default JavaScript viewer (itself simply published as a repository that just happens to be the top node). You could start your own customizations by forking that repository. If you develop a viewer/editor/future plugin component that you think the world should use, send it in as a pull request to the canonical repo.

The other thing I think github should do is go the JetBrains Upstream / Google Grok (if it ever happens) route and provide syntactic / semantic analysis as a service, from which all these visualizers, editors, and other tools are built.

thefox• 13 years ago

This idea is awesome. Thanks for sharing!

Are your internal wiki, recruitment process, Day-to-day operations, etc. on a private repository? Do you have only one repository or do you have multiple repositories for your internal work?

Github For Everything

Related Stories