[ADP-3072] switch documentation rendering tool from emanote to mdbook

[paolino]

• convert format of docs to mdbook
• fix internal links
• fix link to cardano-foundation/cardano-wallet
• not fix external 404 links
• copy over content from adrestia website links
• copy a pdf from there as well

ADP-3072

[srid]

Interesting. Is there a particular set of features Emanote could have supported to obviate this change?

[HeinrichApfelmus]

Interesting. Is there a particular set of features Emanote could have supported to obviate this change?

The main reason for switching was actually that I find the default mdbook theme to be visually more appealing:

• The theme reserves almost all space for the text (e.g. hides by the navigation bar by default), making the text easier to read.
• The navigation bar is more clear, with section numbers and better scrolling behavior.

That's about it, usability of the executable or configuration did not really factor into the decision. 🤔

[srid]

Okay, cool. So that provides some usefulness to doing srid/emanote#505 especially as another person also asked for it.

[HeinrichApfelmus]

Okay, cool. So that provides some usefulness to doing srid/emanote#505 especially as another person also asked for it.

Absolutely. 👍 To me, the visuals of the generated output are much more important than the method to generate them.