@@ -17,7 +17,7 @@ You can install Urbit on any Mac or Unix machine; if you're just trying out Urbi
18Once you're finished, you can [boot your very own ship](/docs/getting-started/booting-a-ship/#step-3-run-the-boot-command). While you can develop in Hoon on your own ship on the live network, we strongly suggest developing on a development ship first.
18Once you're finished, you can [boot your very own ship](/docs/getting-started/booting-a-ship/#step-3-run-the-boot-command). While you can develop in Hoon on your own ship on the live network, we strongly suggest developing on a development ship first.
20−## Getting started
20+## Getting started
22Once you've created your development ship, let's try a basic command. Type `(add 2 2)` at the prompt and hit return. Your screen now shows:
22Once you've created your development ship, let's try a basic command. Type `(add 2 2)` at the prompt and hit return. Your screen now shows:
@@ -67,44 +67,40 @@ Generators are the most straightforward way to write Hoon programs. They are a c
68The simplest type of generator is the **naked generator**. All naked generators are `gates`: functions that take an argument and produce an output. So, to create a generator, all you need to do is write a `gate` and put it into a file in the `/home/gen` directory of your ship as a `.hoon` file. To run a generator named `mygen.hoon`, you would type `+myhoon <argument>` in your ship's Dojo.
68The simplest type of generator is the **naked generator**. All naked generators are `gates`: functions that take an argument and produce an output. So, to create a generator, all you need to do is write a `gate` and put it into a file in the `/home/gen` directory of your ship as a `.hoon` file. To run a generator named `mygen.hoon`, you would type `+myhoon <argument>` in your ship's Dojo.
70−If this doesn't make sense yet, that's okay. In the next lesson, we will walk you through an example `gate` that is run as a generator.
70+If this doesn't make sense yet, that's okay. In the [next lesson](../list-of-numbers), we will walk you through an example `gate` that is run as a generator.
72## Text editors
72## Text editors
74−Writing code is typically done using a text editor, but common editors like Notepad, Microsoft Word, or OpenOffice Writer are not very well suited for programming. You'll want a text editor that is specifically designed for writing code. This will assist with things such as colorizing keywords, finding patterns, matching parentheses and brackets, etc. Text editors can be quite sophisticated, and some are integrated directly with tools for compiling and running programs - these are called IDEs (integrated development environment).
74+Writing code in any language is typically done using a text editor, but common programs like Notepad, Microsoft Word, or OpenOffice Writer are not suitable for programming. You'll want instead a text editor that is specifically designed for writing code. This will assist with things such as colorizing keywords, finding patterns, matching parentheses and brackets, etc.
76−Which text editor you prefer to use is largely a matter of preference, your level of experience, what functionality you desire, and what operating system you run. This frequently means that asking five programmers what their preferred editor is will give you six different answers. If you are brand new to programming then you'll have a more difficult time determining which editor most suits you, and for now it is probably not worth the time to learn about all of the editors in any kind of depth. Any of the newbie-friendly editors listed below will suit you, just avoid the ones that are meant for more experience programmers.
76+Below is a complete list of text editors that have support for Hoon [syntax highlighting](https://en.wikipedia.org/wiki/Syntax_highlighting) -- an important tool for any programming language. For each of these editors, you'll need to download the editor and then you'll need to install some additional syntax-highlighter package. The process for adding Hoon support differs for every editor. For most newbie-friendly text editors, this is easily accomplished from within the editor itself, and you'll learn how to do so following a newbie tutorial for that editor.
78−### List of editors
78+If you are brand new to programming, don't think too much about which editor to use; any of the newbie-friendly options will suit you.
80−Here we aim to maintain a complete list of text editors that have any amount of support for Hoon. The first section are editors known to be friendly to new users, while the second section are editors that are typically only recommended for experienced programmers.
80+### Newbie-friendly text editors
82−For each of these editors, you'll need to download the editor and then you'll need to install some additional package or module that gives it support for Hoon. The process for adding Hoon support differs for every editor. For most newbie-friendly text editors, this is easily accomplished from within the editor itself and you'll learn how to do so following a newbie tutorial for that editor.
82+These editors are easy to use for first-time coders.
84−#### Newbie-friendly text editors
84+#### Atom
85+Atom is free and open-source and runs on all major operating systems. It is available [here](https://atom.io/). A package for Hoon support is maintained by Tlon and may be obtained using the package manager within the editor by searching for `Hoon`.
86−These editors are easy to use for first time coders.
87+#### Sublime
88+Sublime is closed-source, but may be downloaded for free and there is no enforced time limit for evaluation. It runs on all major operating systems. It is available [here](https://www.sublimetext.com/).
88−##### Atom
90+#### Visual Studio Code
89−Atom is free and open source and runs on all major operating systems. It is available [here](https://atom.io/). A package for Hoon support is maintained by Tlon and may be obtained using the package manager within the editor by searching for `Hoon`.
91+Visual Studio Code is free and open-source and runs on all major operating systems. It is available [here](https://code.visualstudio.com/). Hoon support may be acquired in the Extensions menu within the editor by searching for `Hoon`.
92−Sublime is closed source and not free, but may be downloaded for free and there is no enforced time limit for evaluation. It runs on all major operating systems. It is available [here](https://www.sublimetext.com/).
94−##### Visual Studio Code
95−Visual Studio Code is free and open source and runs on all major operating systems. It is available [here](https://code.visualstudio.com/). Hoon support may be acquired in the Extensions menu within the editor by searching for `Hoon`.
97−#### Advanced text edtiors
93+### Advanced text editors
99These text editors have a high learning curve and are only recommended for experienced programmers.
95These text editors have a high learning curve and are only recommended for experienced programmers.
101−##### Emacs
97+#### Emacs
103−Emacs is free and open source and runs on all major operating systems. It is available [here](https://www.gnu.org/software/emacs/). Hoon support is available with [hoon-mode.el](https://github.com/urbit/hoon-mode.el).
99+Emacs is free and open-source and runs on all major operating systems. It is available [here](https://www.gnu.org/software/emacs/). Hoon support is available with [hoon-mode.el](https://github.com/urbit/hoon-mode.el).
105−##### Vim
101+#### Vim
107−Vim is free and open source and runs on all major operating systems. It is available [here](https://www.vim.org/). Hoon support is available with [hoon.vim](https://github.com/urbit/hoon.vim) and is maintained by Tlon.
103+Vim is free and open-source and runs on all major operating systems. It is available [here](https://www.vim.org/). Hoon support is available with [hoon.vim](https://github.com/urbit/hoon.vim) and is maintained by Tlon.
110### [Next Up: Walkthrough -- List of Numbers](../list-of-numbers)
106### [Next Up: Walkthrough -- List of Numbers](../list-of-numbers)