FEEDBACK NEEDED: new RouterOS documentation

I believe I was one of the most frequent users of the page history comparison feature.

For my purposes, it was a direct way to know whether or not I needed to make configuration adjustments when performing mass updates.

Please don't make comparing document versions impossible (or so complicated that people give up).

that's my addiction too!

Given that the Documentation project has transitioned from Alsatian Confluence to Docusaurus, what docu tools can still be adopted and integrated with Docusaurus - based pipeline so the documentation releases are automated and CLI reference kept in sync with the hardware/software releases?

Docusaurus pipeline - AI proposal.pdf (131.9 KB)

manual.mikrotik.com it is not yet indexed on https://context7.com/?q=mikrotik

What is that?

Not my words, gpt ones:

Context7 is a documentation retrieval layer for AI coding assistants that injects up-to-date, version-specific library documentation into the model’s context so generated code matches current APIs instead of stale training data.

My words: it helps AI to understand ROS by processing the actual documentation, instead of utilizing incorrect training data (probably based on forum posts :joy:). Better AI output, more efficient token usage.

Yes, it is.
I'm currently on 4000px wide. Increased --ifm-container-width-xl to 2000px and it's quite ok. Larger value is already uncomfortable.
So, the page should have some max width limit anyway.

P. S. Please consider making different site icons for each site. Currently, website, forum, manual has the same icon displayed on tab in a browser, and it's hard to distinguish them, when you have many opened MT sites and pages at the same time.

I am trying to lookup the documentation for the new from-pool-policy parameter (under /ipv6 address) but I am unable to find it in the new documentation. Putting from-pool-policy in the search box produces an "OR" result list with articles containing one of the 3 words, but not all three.

The old doc site does have the relevant result:

I think the "IP Addressing" article is missing in new manual? Can't find it.

Yeah, the new "Networking Fundamentals" branch misses several things compared to the old "IPv4 and IPv6 Fundamentals".

Under the CLI Reference branch address | RouterOS Manual there is a mention of from-pool-policy, but still incomplete (no description yet). However this does not appear in the search result!

@infabo answer is very good!
Context7 is "one of" the macro indexers for AI. There are others. But, for what I know is the most commonly used.

No entry point per release version...

Should be fixed now. Please recheck if possible. Not sure why, but my FF/Chrome on IOS didn't show that issue thou, so I cannot fully confirm the fix.

We are aware that the current search is a bit basic, we will look at alternative search plugins.

Sitemap added https://manual.mikrotik.com/sitemap.xml

It's here Networking Fundamentals | RouterOS Manual

Works fine now :+1:

You asked for feedback:

that URL simply returns a page with XML code for me.
Edge / Win11

this is what a sitemap is, it is supposed to be an XML. it is the plugin that was suggested here. what did you expect there? https://www.xml-sitemaps.com/validate-xml-sitemap.html

@normis nice improvement!
A useful feature from previous documentation was the history, used to keep track and stay up-to-date with RouterOS changes.
Changelog does not always mention the exact command line that was added or removed.
Is this available also with Docusaurus?

You problably already know, TrueNAS has a wonderful documentation https://www.truenas.com/docs/scale/26/ other than a well managed project (if you want to keep as suggestion).

Will there be a "recently changed" section, or it's gone forever? That was a good way to know what was updated recently...