Discussion: the path forward

[plowsof]

i assume this will be put into #1

these seem to be our options:

• starting with Just the docs + monerodocs original files. for reference, monero-docs master branch looks like https://md.monerodevs.org/
• update the original monerodocs front/backend to their latest versions : for reference: https://md.monerodevs.org/ is a preview of https://github.com/plowsof/md/tree/latest_mkdocs_test
  • the original monerodocs has calls to googleapi's for fonts, this is not the case with the updated version that uses the privacy plugin
  • git-committers plugin to display contributors at the bottom / and also last revision date (compatible with localisation) e.g. this cryptography related page. We can accept contribs from anyone * or commit external contribs using appropriate author name * e.g. MAGIC can submit PR's under a specific account

all of the above is flexible / not been decided on*

[jermanuts]

https://getmonero.dev/ is more up-to-date docs

[nahuhh]

.dev has some updates to it, but also some unnecessary (imo) changes. Its adapted for justthedocs, which has issues with no-js

[dan-is-not-the-man]

I would stick to mkdocs material as it has better plugins and is designed for documentation. As ofrn said no js breaks the drop down menus for justfordocs and also majority of the work has been done already. Also i'm not sure it has localization. With mkdocs material there is plugins:

• localization

• Building Site Offline