Reformat Onionoo's protocol specification to be more useful
Christian started reformatting Onionoo's protocol specification, which is great!
Creating this ticket for the discussion.
So far, Christian made two drafts:
Some random comments:
-
It's difficult to compare the two drafts, because the second draft doesn't contain field descriptions.
-
Adding an example is probably not necessary. Instead, we could add a link to
/summary?limit=4
for a few actual examples. Same for the other resources. -
I like the nested tables in the first draft slightly better than splitting up documents into 1 document object and 2 objects for relays and bridges.
-
The colors, including table borders, look slightly better in the second draft.
-
Adding a menu to the left margin is probably overkill.
-
I like both drafts better than the current version, so thanks for working on this!