[tor-bugs] #33689 [Core Tor]: README cleanups

Tor Bug Tracker & Wiki blackhole at torproject.org
Sun Mar 22 13:04:54 UTC 2020


#33689: README cleanups
--------------------------------+--------------------------
 Reporter:  bduszel             |          Owner:  (none)
     Type:  enhancement         |         Status:  new
 Priority:  Medium              |      Component:  Core Tor
  Version:  Tor: 0.4.3.3-alpha  |       Severity:  Minor
 Keywords:                      |  Actual Points:
Parent ID:                      |         Points:
 Reviewer:                      |        Sponsor:
--------------------------------+--------------------------
 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.).

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/33689>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online


More information about the tor-bugs mailing list