Re: [boost] [doc] Liven up Boost Documentation with Java Script?

Subject: Re: [boost] [doc] Liven up Boost Documentation with Java Script?
From: Boris Schäling (boris_at_[hidden])
Date: 2016-02-26 12:53:38

"Krzysztof Jusiak"  wrote in message 
news:CALNnLfa+WCdCEcqAeX40ORfohCZ3UUnFyZgVicR=ZuDQwEhwNg_at_mail.gmail.com...
>
> * Run the code online (allows to check library with one click)

The #1 request on http://theboostcpplibraries.com/ is to make the output of 
the sample programs available right after the examples. I like that this is 
what happens when I run code online. However it might be better if the 
output was always immediately available (without having to run code first)? 
(This is of course possible by embedding output into static webpages; no 
need for an online compiler.)

I'm very much in favor of providing complete sample programs which users can 
build right away and use as a starting point to play around with libraries. 
However I'm not sure whether users would like to play around with examples 
in a browser (can't remember that I ever wanted to do this)? If they really 
want to, they could copy&paste code to http://melpon.org/wandbox. One could 
provide a button or link next to every example which opens Wandbox and 
copies&pastes code automatically. But I don't know whether there are enough 
users out there who need this?

> * Comments (allows commenting on the documentation)

I think the most important advantage of comments is to interact with users 
who can't be reached otherwise (because they aren't subscribed to mailing 
lists for example). The biggest disadvantage is however that someone has to 
interact with users. If users add comments and nobody replies, it's better 
not to have comments at all. :)

> * Chats (allows discussing issues and solutions)

I guess it's a bit similar as with comments.

Personally I like to see social features being added to the website (and if 
only temporary for a test). For us who we are subscribed to mailing lists it 
may seem unnecessary. But I believe there are lots of users out there we 
could interact with more easily if there were social features on the 
website.

My two cents,
Boris