# Contributing to Arbital

Ar­bital hosts a net­work of ex­pla­na­tions writ­ten and ed­ited by peo­ple like you in or­der to make hu­man­ity’s knowl­edge ac­cessible to ev­ery­one. In or­der to fulfil this idea’s po­ten­tial we need your help, whether that’s as sim­ple as let­ting us know when you want some­thing we’re miss­ing, or as in-depth as writ­ing a multi-page ex­pla­na­tion of a con­cept.

### Writ­ing and im­prov­ing pages

Writ­ing new defi­ni­tion and ex­pla­na­tion pages about spe­cific subtopics is im­por­tant to cre­at­ing the net­work of knowl­edge that the rest of Ar­bital will be based on. See Ar­bital scope for a de­tailed overview of the kinds of pages we’re look­ing for.

The home page shows the most linked to pages which don’t yet ex­ist, but you are wel­come to cre­ate a page for any math topic that read­ers would want to read about. Great ex­am­ples of in­di­vi­d­ual pages

When cre­at­ing pages, pri­ori­tize writ­ing ex­cel­lent sum­maries for the pre­view popup. Put your­self in the mind of some­one who wants a quick but ac­cu­rate idea what the topic is about and check other sum­maries of the con­cept to con­firm you’re cov­er­ing all the cru­cial points. Ex­am­ples of pages with good sum­maries: Log­a­r­ithm, Decit, Group the­ory, Func­tion.

Men­tion #re­views and get­ting feedback

men­tion arcs/​paths once we have a guide for that.

Create new page!

### Where to go next?

The best place to start is right on the home page. It lists pages which could be cre­ated and ex­panded. If you are not sure what kind of con­tent to write, take a look at the ex­em­plar pages pages and write some­thing similar on a math topic you are fa­mil­iar with.

Other places to find things to help with:

### Feed­back and con­tent requests

If you like some­thing, give it a thumbs up to brighten the au­thor’s day! If you see any­thing you think could be im­proved (e.g. ty­pos, style is­sues, or things which could be ex­plained bet­ter) you’re en­couraged to leave a com­ment on the page by high­light­ing the rele­vant text and click­ing the com­ment sym­bol that ap­pears on the right note. Or, if you have an idea about how to im­prove it your­self, pro­pose an edit. Dive right in, you won’t break any­thing!

If you’re try­ing to learn some­thing and find a page is pitched for a differ­ent au­di­ence, you can use the blue “Go faster” note and “Say what?” note menus to re­quest al­ter­nate ver­sions of the page more ap­pro­pri­ate for your back­ground.

### Giv­ing feed­back on the site

If at any point you no­tice a bug, some­thing you think could be im­proved about the site, or some­thing you think is great, let us know! We want to un­der­stand how you in­ter­act with Ar­bital as a reader or ed­i­tor, so we can make it work bet­ter for you. You can send feed­back via an op­tion in the quick menu (or­ange + but­ton in the bot­tom right cor­ner).

### Con­tent release

Ar­bital is fun­da­men­tally col­lab­o­ra­tive. Your origi­nal work will always be saved in edit his­tory, but the pub­lic page is very likely to be mod­ified by other ed­i­tors. Author’s opinions are always worth hear­ing but pages you cre­ate are not yours to con­trol, and you should not ex­pect to have the fi­nal say.

Any con­tent you cre­ate on Ar­bital is re­leased un­der the At­tri­bu­tion 3.0 Un­ported (CC BY 3.0), and may be widely reused (with at­tri­bu­tion).

com­ment:

### Writ­ing guides

If you’ve got some­thing to ex­plain, cre­at­ing com­plete guides we can fea­ture is ex­tremely valuable. This is the most in-depth type of con­tri­bu­tion, but it’s pro­por­tion­ally re­ward­ing. We’ll be putting these in promi­nent places as a demon­stra­tion of how Ar­bital can help ac­cel­er­ate learn­ing. For ex­am­ples of these, see Bayes’ rule: Guide and In­tro­duc­tory guide to log­a­r­ithms (though note that both of these are still be­ing pol­ished). <div>

Children:

Parents:

• Arbital

Ar­bital is the place for crowd­sourced, in­tu­itive math ex­pla­na­tions.

• “path” is the word we usu­ally use.

• (1) Some con­cepts are “big con­cepts,” in which case the main should give a high-level defi­ni­tion and a sweep­ing overview that points peo­ple to­wards many other con­cepts (like group the­ory and log­a­r­ithm in the pages linked above). Th­ese pages should prob­a­bly have a num­ber of other lenses on them, some of which are the be­gin­nings of paths.

(2) Some pages are “nor­mal sized con­cepts,” in which case the main page should define the whole con­cept (in a fairly neu­tral way that a fairly tech­ni­cal reader can un­der­stand), with other lenses that ex­plain the con­cept to differ­ent au­di­ences and provide other stuff like ex­am­ples and ex­er­cises (I tried to do this with https://​​ar­bital.com/​​p/​​3h4/​​)

(3) Some pages are part of paths, which are se­quen­tial posts that spend a whole se­ries in­tro­duc­ing a num­ber of differ­ent as­pects of a big con­cept; I’m cur­rently putting to­gether a log­a­r­ithm se­quence that demon­strates this. (The main posts are done, but I haven’t strung them to­gether yet.)

~ Nate

• This is awk­ward phras­ing.

• would add “by high­light­ing text and us­ing the menu that ap­pears on the mar­gin” (or other text that ba­si­cally says this and also is con­sis­tent with how it works on mo­bile).