on master help sign in
visual changes
4833c63Galen Wolfe-Pauly
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+---
1
7
2# Common objections to Urbit
8# Common objections to Urbit
3
9
@@ -117,7 +123,7 @@ The correct way to think about jets is not to compare them to a perfect interpre
117
123
118Compared 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?
124Compared 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?
119
125
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.
121
127
122Compared 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.
128Compared 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.
123
129
@@ -133,7 +139,7 @@ TLDR: no, it doesn't.
133
139
134We 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.
140We 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.
135
141
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
137
143
138However, 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.
144However, 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.
139
145
docs/learn.md+15−3
@@ -5,8 +5,20 @@ sort: 2
5
5
6# Learn
6# Learn
7
7
8−As a open-source project, writing documentation for Urbit has become a kind of rite of passage for aspiring contributors.
9−
10Learn Hoon from the ground up through our in-house Urbyte series, or delve into the great doc efforts by some of our community members.
8Learn Hoon from the ground up through our in-house Urbyte series, or delve into the great doc efforts by some of our community members.
11
9
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)