Examples in docs are broken (404)

[Zen0x7]

Hi

I was looking the docs and the boost documentation version upgrade is great but something is currently broken...

https://www.boost.org/doc/libs/1_87_0/libs/beast/example/websocket/server/chat-multi/ throws 404.

[ashtum]

This seems like an issue with the new website. Could you please open an issue here: https://github.com/boostorg/website-v2/issues In the meantime, you can use: https://original.boost.org/doc/libs/1_87_0/libs/beast/example/websocket/server/chat-multi/

[sdarwin]

@ashtum docs on the new website are stored in AWS S3. Although "anything is possible" with enough code I believe that out-of-the-box that service does not permit (or easily enable) directory browsing.

It seems /chat-multi/ doesn't take the visitor to a webpage, but rather tries to display a directory listing with many pages:

http_session.cpp shared_state.hpp listener.hpp websocket_session.cpp shared_state.cpp beast.hpp main.cpp http_session.hpp listener.cpp websocket_session.hpp CMakeLists.txt chat_client.html net.hpp Jamfile

Could you create this table of contents in the beast documentation? And link to individual files. Not to a whole directory.

Or include this reference: https://github.com/boostorg/beast/tree/develop/example/websocket/server/chat-multi

[ashtum]

@ashtum docs on the new website are stored in AWS S3. Although "anything is possible" with enough code I believe that out-of-the-box that service does not permit (or easily enable) directory browsing.

It seems /chat-multi/ doesn't take the visitor to a webpage, but rather tries to display a directory listing with many pages:

http_session.cpp shared_state.hpp listener.hpp websocket_session.cpp shared_state.cpp beast.hpp main.cpp http_session.hpp listener.cpp websocket_session.hpp CMakeLists.txt chat_client.html net.hpp Jamfile

Could you create this table of contents in the beast documentation? And link to individual files. Not to a whole directory.

Or include this reference: https://github.com/boostorg/beast/tree/develop/example/websocket/server/chat-multi

Yes, instead of linking to a directory path, we can list the related files in docs: https://www.boost.org/doc/libs/latest/libs/beast/doc/html/beast/examples.html#beast.examples.chat_server

[vinniefalco]

is it possible that this was a function of the old website? there could be a php script which turns the directory contents into a webpage?

[sdarwin]

is it possible

yes, of course that's it.
however, it's worthwhile to review boost libraries to see how frequently this feature is used. maybe rarely. If that is the case, specific index.html files could be generated, or hyperlink out to github.com's directories. Are there any other examples of the issue...

[vinniefalco]

It would be better for library documentation to not rely on an external facility which converts a filesystem directory into an index page. Maybe it could be a tool which the library explicitly invokes?

[Zen0x7]

I'll link the related issue from the other repository.

IMHO, this should aim for a retroactive solution (considering older versions too), and ideally follow a Liskov-like principle — in other words, it would be great if the previous behavior could be restored with as little overhead as possible.

https://github.com/boostorg/website-v2/issues/1813