vanilla-os / chronos-frontend Goto Github PK

This could work similar to the blog posts on website.

Ref. GitHub markdown syntax :- https://github.com/orgs/community/discussions/16925

Currently, there is a quite a lot of space wasted on generic desktop screens for the dropdown as it's min-width is 12rem, removing the min-width will make it dynamic based on the characters, it will look much better too:

Before:

After:

This will be very useful for viewing the docs from mobile (where a significant portion of the screen when reading the articles is taken up by this header).

Reference images (desktop)

Ref. current handbook landing page https://handbook.vanillaos.org/

Allow featuring posts on a separate page (similar to how we currently have it in the handbook) or at the top by setting featured: yes parameter in the page's header.

Related Vanilla-OS/Chronos#4

Reference Video

I was able to reproduce the same error on mobile.

We can have something like edit-link: option in the header so that we can directly link to the file on GitHub so readers can open a PR to it. (Similar to other docs solutions)

Currently, the articles in the Docs collection are randomly arranged, this would confuse new users on what to read first. So I would suggest adding an option to specify the sequence/order of pages that docs team members can curate for a better beginner-friendly experience for specific collections.

In the article, we can have a tag like version: 2.0 with identifier: which while reading, chronos can match the identifier to show alternative versions at the bottom of the page for old documentation (this will also be useful in having support for old docs + in the future help app).

In long guides, with a lot of sections like Manpages (i.e. https://docs.vanillaos.org/docs/en/apx-manpage); It would be better if I could independently scroll through the Navigation section and select it, instead of scrolling through the whole window to access the contents.

This page could include information like translation coverage (the ratio of no. of translated pages to the no. of English pages), Number of articles, commonly used tags/labels (if implemented), etc.

There is a minor typo ("tecnical") in the description of the Docs collection, fixed it here at 497c035. I am creating this issue as a reminder to update the Chronos configuration file in the production server (for the same).

Reference Image

Currently, it is available in light mode only.

Currently, when Javascript is disabled the page is blank. Similar to the main website it would be great if a message is displayed when Javascript is disabled, linking users to the collections source repository i.e. documentation and handbook in this instance; allowing them to read it (even when they have it disabled as GitHub and most popular Git remote repository hosts support viewing content even when Javascript is disabled).

Let's say you are clicking on the manpage tag here then all guides tagged with manpage should be displayed. This way we don't need to navigate through the tags menu in the top right to find articles under a specific one.

Similar to our website it would be nice to see the reading time for each articles/guides.

Similar to how we link to GitHub profiles in the handbook.

Reproduce

• Open https://docs.vanillaos.org/collections/docs
• Search for something like "Aaabbc" or that isn't an Article Title