# Beeminder Wiki?

**URL:** <https://forum.beeminder.com/t/beeminder-wiki/5778>\
**Category:** Akrasia\
**Created:** [September 16, 2019, 11:11am UTC](https://forum.beeminder.com/t/beeminder-wiki/5778 "2019-09-16T11:11:54Z")\
**Posts on this page:** 16\
**Page:** 1

<div class="post-metadata">

**Author:** ![narthur](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/narthur/32/5113_2.png) [@narthur](https://forum.beeminder.com/u/narthur)\
**Post date:** [September 16, 2019, 11:11am UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/1 "2019-09-16T11:11:54Z")

</div>

Has anyone created a Beeminder wiki yet? There’s so much great stuff being built by so many people (integrations, scripts, articles, a book, user styles, etc), it would be great if we had a place where we could collaboratively keep track of it all.

---

<div class="post-metadata">

**Author:** ![byorgey](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/byorgey/32/70_2.png) [@byorgey](https://forum.beeminder.com/u/byorgey)\
**Post date:** [September 16, 2019, 9:51pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/2 "2019-09-16T21:51:43Z")

</div>

Someone did try 5 years ago but it didn’t go anywhere: [Interested in a Beeminder Wiki?](https://forum.beeminder.com/t/interested-in-a-beeminder-wiki/180)

I say that merely as a statement of fact, not as a way to discourage you. I like the idea of a wiki too, though personally I would not have much time/effort to spare on curating it.

---

<div class="post-metadata">

**Author:** ![narthur](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/narthur/32/5113_2.png) [@narthur](https://forum.beeminder.com/u/narthur)\
**Post date:** [September 16, 2019, 10:20pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/3 "2019-09-16T22:20:20Z")

</div>

Hmm, thanks for the context.

I’m still interested in throwing something up, even if I end up being the one doing most of the curating.

I’m thinking maybe a super dumb GitHub repo containing markdown files, turned into a site using GitHub Pages? We could always get fancier later, but seems like that would be the simplest / cheapest way to get things started. Also forking, issues, etc…

---

<div class="post-metadata">

**Author:** ![dreev](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/dreev/32/4311_2.png) [@dreev](https://forum.beeminder.com/u/dreev)\
**Post date:** [September 17, 2019, 5:05am UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/4 "2019-09-17T05:05:10Z")

</div>

😍 Thank you for proposing this! My answer from last time stands:

> [@Interested in a Beeminder Wiki?](https://forum.beeminder.com/t/interested-in-a-beeminder-wiki/180/8):
>
> My guess is that this is the kind of thing it’s tricky to get and maintain critical mass for. Reminds me of the [Beeminder subreddit](http://reddit.com/r/beeminder), which I’m delighted exists but it’s clear to everyone that all the cool kids are over here so it’s hard to find motivation to put in effort over there. If folks prove me wrong and the wiki picks up steam, I will be very excited. And definitely count my vote and willingness to contribute to it. Also say the word and I’ll shout it from the twittertops and beemails a…

But I sure want to be proven wrong on that and, to reemphasize, will help in whatever way makes sense. Including making people I’ve gotten to know from here in the forum (like @narthur) collaborators on [Beeminder’s GitHub org](http://github.com/beeminder) if that’s where it makes sense to host such a thing. (Would just need you to sign [beeminder.com/cla](http://beeminder.com/cla).)

PS: One new slightly wiki-like thing since that last thread is [help.beeminder.com](http://help.beeminder.com) (but I know you mean something focused on the broader community, which sounds wonderful).

PPS: Also potentially relevant is the [Beeminder Integrations MEGALIST](https://forum.beeminder.com/t/beeminder-integrations-megalist/5091)

---

<div class="post-metadata">

**Author:** ![eugeniobruno](https://avatars.discourse-cdn.com/v4/letter/e/f475e1/32.png) [@eugeniobruno](https://forum.beeminder.com/u/eugeniobruno)\
**Post date:** [September 17, 2019, 9:59am UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/5 "2019-09-17T09:59:11Z")

</div>

I think this could work much more than a beeminder subreddit could. With a subreddit you need a constant stream of new stuff; a wiki can stay there and occasionally accumulate new information.

People can check once in a while new changes made to pages to make sure no anonymous user has gone on a deletion rampage and maybe add something cool they’ve thought about, or one can go there and search for the information that’s being slowly accumulating.

---

<div class="post-metadata">

**Author:** ![narthur](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/narthur/32/5113_2.png) [@narthur](https://forum.beeminder.com/u/narthur)\
**Post date:** [September 17, 2019, 11:24am UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/6 "2019-09-17T11:24:10Z")

</div>

> [@dreev](#):
>
> Including making people I’ve gotten to know from here in the forum (like @narthur) collaborators on [Beeminder’s GitHub org](http://github.com/beeminder) if that’s where it makes sense to host such a thing. (Would just need you to sign [beeminder.com/cla](http://beeminder.com/cla).)

I think that would be the logical place to put it if we were to make it available at [wiki.beeminder.com](http://wiki.beeminder.com) or [beeminder.com/wiki](http://beeminder.com/wiki). Is that something you’d like to do?

Also, if we did that, would that mean that everyone who wanted to submit a pull request would need to sign the CLA?

---

<div class="post-metadata">

**Author:** ![eugeniobruno](https://avatars.discourse-cdn.com/v4/letter/e/f475e1/32.png) [@eugeniobruno](https://forum.beeminder.com/u/eugeniobruno)\
**Post date:** [September 17, 2019, 11:47am UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/7 "2019-09-17T11:47:30Z")

</div>

> [@dreev](#):
>
> (Would just need you to sign [beeminder.com/cla](http://beeminder.com/cla).)

Just sent an unsolicited CLA signature, just in case I happen to send some PRs in the future 🙂

---

<div class="post-metadata">

**Author:** ![dreev](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/dreev/32/4311_2.png) [@dreev](https://forum.beeminder.com/u/dreev)\
**Post date:** [September 17, 2019, 4:48pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/8 "2019-09-17T16:48:10Z")

</div>

> [@narthur](#):
>
> I think that would be the logical place to put it if we were to make it available at [wiki.beeminder.com](http://wiki.beeminder.com) or [beeminder.com/wiki](http://beeminder.com/wiki). Is that something you’d like to do?

Yeah, perfect. Let’s say [wiki.beeminder.com](http://wiki.beeminder.com) because then it can be hosted on GitHub and cname’d or whatever.

> [@narthur](#):
>
> Also, if we did that, would that mean that everyone who wanted to submit a pull request would need to sign the CLA?

Oh, no, just for someone who was helping set it up or wanted to push changes directly instead of as PRs. Er, I think. For code I guess we’d need that signed even to accept PRs. For prose that wouldn’t make sense but this might be a @mary question.

We can figure it out case-by-case in the meantime!

---

<div class="post-metadata">

**Author:** ![adamwolf](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/adamwolf/32/484_2.png) [@adamwolf](https://forum.beeminder.com/u/adamwolf)\
**Post date:** [September 17, 2019, 5:22pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/9 "2019-09-17T17:22:03Z")

</div>

What’s the advantage to having folks do PRs and running a site out of Github Pages rather than using the Github wiki feature?

---

<div class="post-metadata">

**Author:** ![dreev](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/dreev/32/4311_2.png) [@dreev](https://forum.beeminder.com/u/dreev)\
**Post date:** [September 17, 2019, 5:36pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/10 "2019-09-17T17:36:43Z")

</div>

Ah, yeah, as long as it’s a public repo (and we could make one just for this) then the built-in wiki might be great. That’s what I used for the Commits.to spec, for example: [https://github.com/commitsto/commits.to/wiki](https://github.com/commitsto/commits.to/wiki) – but that may still require PRs for outside people to make changes?

We could also model it on the Beeminder API docs: [https://github.com/beeminder/apidocs](https://github.com/beeminder/apidocs)

---

<div class="post-metadata">

**Author:** ![mary](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/mary/32/317_2.png) [@mary](https://forum.beeminder.com/u/mary)\
**Post date:** [September 18, 2019, 4:15pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/11 "2019-09-18T16:15:33Z")

</div>

Are there good wiki services for those for whom the word Github strikes fear into their hearts? Are there wikis that are super user-friendly, with only a little power compromised?

Alternatively, we could use the documents pages we have and update the documents ourselves with user-submitted content, since submissions will need to be reviewed anyway. So it would have the same format as the other pages, and we could make use of the very pretty [https://help.beeminder.com/collection/1-beeminder-help](https://help.beeminder.com/collection/1-beeminder-help) It wouldn’t be a wiki, so much as our regular manual / help pages, but very helpfully updated with user content.

---

<div class="post-metadata">

**Author:** ![dreev](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/dreev/32/4311_2.png) [@dreev](https://forum.beeminder.com/u/dreev)\
**Post date:** [September 18, 2019, 4:31pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/12 "2019-09-18T16:31:27Z")

</div>

I agree with all the things! We can accept content for things like [help.beeminder.com](http://help.beeminder.com) but also if @narthur is inspired to make a wiki on GitHub with more user-ish / third-party kind of content than makes sense for [help.beeminder.com](http://help.beeminder.com) there’s absolutely a big green light for that too!

As for a less intimidating wiki than GitHub, let’s assume GitHub is the best we’ve got for now and if something more compelling pops up we’d migrate. (It’s very true that GitHub is intimidating for non-programmers and that’s a big downside.)

---

<div class="post-metadata">

**Author:** ![eugeniobruno](https://avatars.discourse-cdn.com/v4/letter/e/f475e1/32.png) [@eugeniobruno](https://forum.beeminder.com/u/eugeniobruno)\
**Post date:** [September 18, 2019, 7:29pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/13 "2019-09-18T19:29:32Z")

</div>

this is for the more user-ish content wiki - I think it makes the most sense for it to be separated from the official help:

a mediawiki instance is out, right? anyone wants a giant pile of PHP on their server? 🙂

---

<div class="post-metadata">

**Author:** ![mary](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/mary/32/317_2.png) [@mary](https://forum.beeminder.com/u/mary)\
**Post date:** [September 18, 2019, 8:49pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/14 "2019-09-18T20:49:34Z")

</div>

And we can also borrow wiki content for the help docs and have it both ways. (We should probably include a “Yeah, we’re totally going to plagiarize your content, so you should be cool with that if you’re posting here” warning 🙂 )

---

<div class="post-metadata">

**Author:** ![narthur](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/narthur/32/5113_2.png) [@narthur](https://forum.beeminder.com/u/narthur)\
**Post date:** [September 18, 2019, 10:07pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/15 "2019-09-18T22:07:25Z")

</div>

Does anyone know if there’s something like [https://www.gitbook.com/](https://www.gitbook.com/) that would give a more user-friendly wiki-like user interface to a GitHub repo? My wish list would be:

- Modern editing interface
- Retains commit history in GitHub
- Can handle users forking and editing in GitHub without using the tool
- Doesn’t limit the number of users who can edit
- Uses straight markdown files, or close to it
- As a consequence of the previous, is publishable to any domain via GitHub Pages
- Free… =P

Maybe I’m asking for the world. But GitBook would be ideal if it didn’t charge by the user. (It’s meant for teams to build documentation, not for allowing unlimited visitors to edit a wiki.)

---

<div class="post-metadata">

**Author:** ![mufflon](https://sea1.discourse-cdn.com/flex019/user_avatar/forum.beeminder.com/mufflon/32/2394_2.png) [@mufflon](https://forum.beeminder.com/u/mufflon)\
**Post date:** [September 21, 2019, 8:55pm UTC](https://forum.beeminder.com/t/beeminder-wiki/5778/16 "2019-09-21T20:55:36Z")

</div>

> [@mary](#):
>
> “Yeah, we’re totally going to plagiarize your content, so you should be cool with that if you’re posting here”

CLA / CC-BY?

I’d be quite interested in a wiki too.
