This new approach doesn't require version numbers and make easier for contributors to understand the status
of the document. There are only 3 states:
- Outdated: The page is outdated and might not work as expected
- Untranslated: The page needs to be translated
- Translation outdated: The page is translated, but the original (English) document has been updated
To mark a guide as outdated, we change the boolean of the front matter entry 'outdated' in /resources/user-guides/GUIDE.
If 'False', the guide is updated. If 'True' all versions of the guide (English included) will show a warning at the bottom
of the page.
The other 2 states are related to the status of the translated pages and we control them from the language-specific
user guides: /_i18n/LANG/resources/user-guides/GUIDE. At the top of the page a snippet will include 2 parameters:
- translated: "yes" if the page is translated, "no" if it's not.
- translationOutdated: "yes" if the translation is outdated, "no" if it's not
This new system aims to be simpler than the precedent, avoiding to compare versioning numbers and using a higher level
system instead (yes, no, True, False). I also removed the middle way status 'only minor changes', because if there are
only minor changes that don't affect the usability of the guide, we don't need to point it out.
The old system was complex and people didn't use it. These changes will hopefully make things easier for translators and
other contributors.
- Split page vertically and add new section: 'External resources'
- Add description for each resource
- Add pics to suggest where the content is located (web page, github, internal doc)
- Added anchors. Visible when hovering on the tabs
- Added "More info:", which links to related sections on getmonero (contributing, user guides, etc)
- Added toc
- Added links to related Moneropedia entries in the answers
- Added side box with more resources and info
- 10 new questions/answers:
- Can I avoid to download the entire blockchain?
- why my wallet needs to be scanned everytime I open it?
- Is it dangerous to run a personal node?
- Is it dangerous to use a remote node? what's the data a node operator can get from me?
- How can I contribute?
- What's the meaning of [technical word]?
- What wallet should I use?
- Can't see funds. Did I just lose all my Monero?
- How can I connect my node via Tor?
- Why does the blockchain need so much space?
