Hello everyone, I just started playing around with Tor a few days back so as one could expect I started with `README.1st.md` file. I realized that different `*.md` files are not consistent style-wise so I decided to clean them up a bit. Brief summary: - no empty line at the very beginning of the file, - single empty line between sections (sometimes there were two) ``` ... end of the sentence. New Section ---- ``` rather than ``` ... end of the sentence. New Section ---- ``` - external links use [name](url) format, - there is no single space in front of the section name ``` Foo === ``` is changed to ``` Foo === ``` Which fixes syntax issues in editors like GNU Emacs with enabled markdown preview. - I tried to check all links (local and external) and fix the ones which were broken. For example **the Tor proposal process** inside `README.1st.md` or `doc/WritingTests.txt` were changed to `.../doc/HACKING/WritingTests.md` in few places). ---- At the very end of `README.1st.md` file there are some TODO (I think?) sections. I wrapped them around in "TODO" section. ``` TODO ----------------------- XXXXX also describe doc/HACKING/WritingTests.md torguts.git torspec.git The design paper freehaven.net/anonbib XXXX describe these and add links. ``` However I am not sure if these are still needed there. Most of these topics are mentioned already in this file and linked to other files (WritingTests, torspec, etc.).