on master help sign in
visual changes
commit4833c63a0cbb345b1d1ef31f50d11426568189c7 authorGalen Wolfe-Pauly <root@office-for.com> dateTue 14 Feb 2017, 14:35 (10 years ago) parentd9175ff
2 files changed+23−5
docs/about/objections.md+8−2 docs/learn.md+15−3
docs/about/objections.md+8−2
@@ -1,3 +1,9 @@
1+---
2+navhome: '/docs'
3+next: True
4+sort: 5
5+title: Common objections to Urbit
6+---
17
28# Common objections to Urbit
39
@@ -117,7 +123,7 @@ The correct way to think about jets is not to compare them to a perfect interpre
117123
118124Compared to both intrinsics and an FFI, your jets have one key disadvantage: they need to be specified in pure code. You may not have this executable specification, which means you need to write it. Is this really so bad for your development process? An executable specification? Which can be trivially tested against the efficient implementation?
119125
120−Compared to intrinsics, jets give you true separation between mechanism and policy; only the interpreter, not the programmer and not the compiler, needs to know what's accelerated.
126+Compared to intrinsics, jets give you true separation between mechanism and policy; only the interpreter, not the programmer and not the compiler, needs to know what's accelerated.
121127
122128Compared to an FFI, jets preclude I/O, so can be trivially sandboxed. Except that the programmer needs to mark routines which may benefit from optimization with a hint, here too we separate mechanism (efficient implementation) from policy.
123129
@@ -133,7 +139,7 @@ TLDR: no, it doesn't.
133139
134140We can prune the event log because the Urbit transition function doesn't have any access to the event history -- just the current state and the current event.
135141
136−Urbit defines the semantics of a complete event log. It doesn't and can't require an implementation to maintain the whole log. It can maintain a checkpoint and the log since that checkpoint. The current implementation of Urbit maintains
142+Urbit defines the semantics of a complete event log. It doesn't and can't require an implementation to maintain the whole log. It can maintain a checkpoint and the log since that checkpoint. The current implementation of Urbit maintains
137143
138144However, any practical urbit maintains a periodically updated checkpoint. Our present implementation doesn't provide a way to prune the event log, but that's just a missing feature.
139145
docs/learn.md+15−3
@@ -5,8 +5,20 @@ sort: 2
55
66# Learn
77
8−As a open-source project, writing documentation for Urbit has become a kind of rite of passage for aspiring contributors.
9−
108Learn Hoon from the ground up through our in-house Urbyte series, or delve into the great doc efforts by some of our community members.
119
12−<list/>
10+#### Urbytes
11+
12+<list dataPath="/docs/learn/urbyte/" />
13+
14+#### Community docs
15+
16+* `~master-morzod` -
17+[docs](http://micnus-tarwyl-haltem-linhut--dilhul-talbes-wolnyx-lasbud.urbit.org/docs/), [`fora` post](https://urbit.org/fora/posts/~2016.12.25..06.35.44..a1ec~/)
18+
19+* `~hidduc-posmeg` -
20+[docs](https://fosnut-dandut.urbit.org/pages/hidducs-notes/tutorial), [`fora` post](https://urbit.org/fora/posts/~2017.2.12..21.54.40..6fde~/)
21+
22+* `~palfun-foslup` - [Urbit by Doing](https://github.com/Fang-/Urbit-By-Doing)
23+
24+* `@knubie` - [Learning Hoon](https://github.com/knubie/learning-hoon)