README cleanups

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 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.).