Arbital page

A page is the pri­mary build­ing block in Ar­bital. Pages can rep­re­sent con­tent, users, meta tags, and more. This page cov­ers or links to most page fea­tures that you’ll run into as an ed­i­tor.

Page settings

Alias is a short name given to the page. It’s mostly used to quickly link to the page in Mark­down.

Page type de­ter­mines what kind of page this is: stan­dard wiki, lens, ques­tion, an­swer, com­ment, etc… Most of the time this is set for you au­to­mat­i­cally and you can’t edit it.

com­ment: Vote type de­ter­mines what kind of vot­ing this page will have. Once the type is set, it can’t be changed, only turned off/​on.

Sort chil­dren de­ter­mines how the chil­dren pages are sorted:

  • By Likes (de­fault): the pages with most likes will ap­pear first

  • Re­cent First: the most re­cently cre­ated pages will ap­pear first. (Set this for your blog.)

  • Oldest First: the old­est page will ap­pear first. (Set this when you are writ­ing a se­quence of posts or a book.)

  • Alpha­bet­i­cally: self-ex­plana­tory. If you name your child pages with a nu­mer­i­cal pre­fix, e.g. “3. Step Three”, then this op­tion will sort them as you would ex­pect.

Permissions

If you own the page, you will also be able to change its per­mis­sions.

Edit group de­ter­mines who can edit the page. Only the mem­bers of the set group will be able to edit it.

Edit karma lock will re­quire the user to have that amount of karma be­fore they can edit the page.

Relationships

Par­ents show what pages will be the par­ents of this page. This page will show up un­der “Chil­dren” on those pages.

Chil­dren show what pages will be the chil­dren of this page. This page will show up un­der “Par­ents” on those pages.

Tags shows what tags this page has. They will show up as a list of #hash­tags on the page.

Re­quire­ments shows what re­quire­ments the page has. Ar­bital will in­struct the user to read them be­fore read­ing the page.

You can read more about re­la­tion­ships here.

Similar pages

Ar­bital will dis­play other pages that are similar to the one you are edit­ing or cre­at­ing. This way, you won’t ac­ci­den­tally cre­ate a du­pli­cate of an­other page that you didn’t know ex­isted.

Alias compilation

When a page is saved (even dur­ing auto-saves), all the ali­ases are con­verted to their cor­re­spond­ing ids. When the page is opened for edit­ing, all the ids are au­to­mat­i­cally con­verted to cor­re­spond­ing ali­ases. This way you can change the alias on any page and don’t have to worry about edit­ing links on all the other pages, which with­out this fea­ture would still use an ob­so­lete alias.

History

When you are done edit­ing a page, you can click “Pub­lish” to re­place the cur­rently live ver­sion with yours. Un­til then, no­body will see your changes. The old ver­sions are still stored safely on the server, and can be seen in the change log.

You can see pre­vi­ous ver­sions of the page in the his­tory tab. You can load up older ver­sions, perform a diff, and even re­vert if nec­es­sary.

Autosaves

When you are edit­ing a page, it’s au­to­mat­i­cally saved ev­ery 5 sec­onds. When you open a page for edit, if you have an au­tosave, it will be loaded in­stead of the cur­rently live ver­sion. You can only have one au­tosave at any given time. A new au­tosave always over­writes the old one. When you aban­don a page, the au­tosave is deleted.

Snapshots

You can man­u­ally cre­ate a snap­shot of the cur­rent ver­sion. You can have as many snap­shots as you want. Use them to store po­ten­tial changes /​ snip­pets for the page and to try out differ­ent paths in your writ­ing.

When to cre­ate a new page?

  • When some topic /​ claim is not cov­ered any­where else.

  • When some topic /​ claim gets too com­pli­cated, you can break it down into sev­eral pages.

  • When you see over­lap­ping dis­cus­sions about the same thing on other blog/​wiki pages, cre­ate a page to en­com­pass all of that dis­cus­sion, and bring it to this new page.

When to edit a page?

  • If you see a way to im­prove or add to the pre­sented in­for­ma­tion.

  • If you see a clear mis­take /​ typo /​ van­dal­ism.

  • If you are not sure if it’s a mis­take, leave a com­ment.

How to edit a wiki page?

  • On the page you want to edit, click on the Edit but­ton with the pen­cil icon.

  • If you want to cre­ate a new page, click the com­pose but­ton in the bot­tom right cor­ner.

  • En­ter the page’s ti­tle and click­bait.

  • Use Mark­down syn­tax to edit the page.

  • Don’t for­get to cre­ate the sum­mary sec­tion.

  • Check the page set­tings.

  • Click Pub­lish (or Pre­view) when you are ready for your ver­sion of the page to go live.

What makes a good Ar­bital page?

  • It’s longer than a few para­graphs, but not longer than a few full screens.

  • It cov­ers one ques­tion /​ claim /​ sub­ject.

  • Longer pages are bro­ken down into sec­tions with head­ers.

  • It links to other pages that cover other sub-ques­tions /​ sub-claims /​ sub-top­ics.

  • The re­la­tion­ships (par­ent-child, tags, re­quire­ments) are set cor­rectly.

Children:

Parents: