Multi lingual documentation

[jooola]

Having a multi lingual documentation would be awesome after the documentation has been rewritten and modernized.

This has been requested by french people willing to learn how Libretime works.

We should focus the user manual, not necessarily the admin/dev/advanced guides/manual, as we expect admin that install the server to understand English.

This is a long term goal.

[zklosko]

That's a very important thing we need to work on. I'll pin this so it doesn't go anywhere.

[zklosko]

I just heard of Docusaurus, a documentation-focuses SSG that uses React as its base. It has a lot of features we're looking for: search plugin without 3rd party clouds, i18n, syntax highlighting, and easy CI/CD. If anyone's interested, I have a demo here which is somewhat completed.

[paddatrapper]

That 404s?

[zklosko]

My bad. Try again.

[paddatrapper]

That's pretty cool! I want to have a look at the code at some point, but the final product is nice and sleek. Having a blog section also appeals to me because it would be a nice way to highlight some use-cases, new features, etc as we develop them

[jooola]

Cool site, Docusaurus seem like a nice tool, I overlooked it while searching for Jekyll alternative, another candidate I had was Vuepress which isn't yet as powerful.

I never used MDX, it brings a lot of features material/mkdocs was providing, this is a good thing.

I guess this overlaps with the previous #8 ? @zklosko Maybe you can move this discussion there ?

[zklosko]

Update for those just finding this: We've successfully merged in Docusaurus and we're looking for people who can write translations for the documentation.