You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The current site misses out on a few important features now standard across modern documentation sites. Such as:
Sidebar for quick navigation between pages and better context of the site heirarchy,
Previous and next link to pages,
Fixed TOC on top right for better context of current position in the page content hierarchy, and
Search
This causes significant inconvenience to developers browsing the site, especially when in need for quick reference. Proposing to migrate from Metalsmith to Docusaurus as it provides the above features out of the box along with many others.
I tried this migration with my fork, and was able to do it with minimal changes in the existing markdown contents and without breaking the existing links and redirects. Refer:
@Aleksandr-JS-Developer it's a one time effort. I have already created this non-breaking PR and the resulting site would be as good as the current one w.r.t existing experience, plus it will also have the additional features mentioned in the issue except search. However, I haven't been able to get any response from the maintainers, thus stuck with a pending PR.
The current site misses out on a few important features now standard across modern documentation sites. Such as:
This causes significant inconvenience to developers browsing the site, especially when in need for quick reference. Proposing to migrate from Metalsmith to Docusaurus as it provides the above features out of the box along with many others.
I tried this migration with my fork, and was able to do it with minimal changes in the existing markdown contents and without breaking the existing links and redirects. Refer:
I will go ahead a raise a PR for the migration without Search feature. Read here for the Docusaurus search support.
The text was updated successfully, but these errors were encountered: