RIIR icon indicating copy to clipboard operation
RIIR copied to clipboard

Rewrite documentation in Esperanto

Open cjdelisle opened this issue 9 years ago • 5 comments
trafficstars

I think the documentation would be much more comprehensible and clear if it were written in a politically-neutral language that was built from the ground up, for example: Esperanto.

cjdelisle avatar Mar 23 '16 07:03 cjdelisle

I wouldn't call a gendered language politically neutral, Why Not Lojban? https://en.wikipedia.org/wiki/Lojban

ehmry avatar Mar 23 '16 09:03 ehmry

lojban

ansuz avatar Mar 23 '16 15:03 ansuz

I just don't think either is proven to be dependable enough. You should go with a language that's been around for longer, so you don't have to worry about it going away. That's why I propose Icelandic. It'll be a lot more dependable. (Please, if you speak Icelandic, don't take offense. I think Icelandic is an excellent language, although probably not the best one for international documentation)

montagsoup avatar Mar 23 '16 20:03 montagsoup

I think the docs should just be in Rust itself, in comments. We can break up the sections into different modules. I think the memory safety features will make sure people remember all the important bits of the documentation, and the not important bits too. Also, i think the drive for clear ownership semantics would help disambiguate any confusion about who said what. With proper understanding of a threading model without data races, people will make edits to the docs safely.

And the excellent C bindings would make it easy for us to import the PGP book, for good privacy guarantees.

jbenet avatar Jul 04 '16 10:07 jbenet

I'd like to point out that Ido is much better Esperanto, than Esperanto.

dpc avatar Jul 07 '16 04:07 dpc