boostorg / boostorg/website-v2

Graceful degradation.

Open
#334 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
18
Forks
28
Avg merge
2d 14h
Merged PRs (30d)
81

Description

I am frequently browsing documentation in `links` or `lynx`, because our target system does not have anything better.

Please, make sure that the website gracefully degrades when the client does not support all the features of the most recent Chrome.

Example:

### Old website

![image](https://github.com/cppalliance/temp-site/assets/2077025/ab0abb76-5d7a-44fe-8f3e-35eb396e281e)

![image](https://github.com/cppalliance/temp-site/assets/2077025/64d626aa-c12c-4515-8cde-f8eb3dc9876c)

![image](https://github.com/cppalliance/temp-site/assets/2077025/01a35a44-d603-421e-8280-7738ce8b2f5a)

![image](https://github.com/cppalliance/temp-site/assets/2077025/9b4d7323-883d-478b-9827-526ee91e42a5)

![image](https://github.com/cppalliance/temp-site/assets/2077025/087eeb9c-727a-4914-b6fe-9549d8cdaee7)

Useful and usable, 5 pages of pure content, and I can ever get a full sitemap for free, because the menu automatically expands.

### New website

![image](https://github.com/cppalliance/temp-site/assets/2077025/188a318c-77d7-4413-b04f-01856e714073)

![image](https://github.com/cppalliance/temp-site/assets/2077025/cd84fe12-448b-4a8c-a620-a63873bdd4b2)

![image](https://github.com/cppalliance/temp-site/assets/2077025/b74c2aa9-1974-4d93-bedd-21aa2815ba84)

![image](https://github.com/cppalliance/temp-site/assets/2077025/14630bf3-57a6-4b8d-8796-066d39b59f5f)

1. The _good_ thing about the new website is that in `links` it has a navigation menu at the top, which is just very user-friendly, and an excellent feature. However, I don't users hardly need two copies of that menu.

The rest I wouldn't consider very helpful.

1. The front page is not really speaking about what boost is, not nearly as much helping the user to grasp most of the boost (as an organization, and as a set of libraries) logic from just a single page. (And browsing and clicks are very expensive for human brain.)
2. It is also not giving a direct download link to the most recent release.
3. I also don't see links to RSS, which is still a useful news source, even though newer standards exist. (I would ask to consider equipping the website with hEntry Semantic Web tags, but those are not yet widely supported.)
4. The wonderful site map is entirely missing.

And with all that, the pages are more or less equal in size:

```
-rw-r--r-- 1 lockywolf users 26K May 12 09:40 new-boost.txt
-rw-r--r-- 1 lockywolf users 27K May 12 09:40 old-boost.txt
```

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by opening the website in links and lynx and compare the old and new examples described in the issue. Review the page structure and navigation entry points, then determine how the requested content, release link, RSS links, and sitemap should remain usable without modern Chrome features. Done means the site remains useful and navigable in limited clients.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
frontend, web-dev
Issue type
Bug
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.