<div dir="ltr"><div><div>Hi Stefano:<br><br></div><div>I think it would be an interesting experiment to try out. However, do I have one concern:<br></div><div><br></div>Are you suggesting that the Ask widget replace the existing Disqus comments on the docs page as a mechanism for users to ask questions, or would this be an addition?<br>
<br>I don't think we should do *both* Disqus comments and the Ask widget at the same time. I think having both on a page would confuse users about which feedback mechanism they should use.<br><br></div>Lorin<br><div><div class="gmail_extra">
<br><br><div class="gmail_quote">On Wed, Oct 30, 2013 at 8:56 PM, Stefano Maffulli <span dir="ltr"><<a href="mailto:stefano@openstack.org" target="_blank">stefano@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hello folks,<br>
<br>
I have been talking with Anne and Tom about trying to capture more<br>
effectively feedback from users that browse the Documentation and at the<br>
same time, capture the doubts/pain of users back into the<br>
document-writing process.<br>
<br>
One idea I've been toying with is to provide a place for users to ask<br>
questions if/when they have doubts about the documentation and get those<br>
questions answered by a wider community. At the same time, I thought it<br>
would be good to have a way for doc writers to identify the parts of the<br>
documentation that are more likely to attract questions.<br>
<br>
With these ramblings in mind, I spoke with the developers of Askbot<br>
(powering <a href="https://ask.openstack.org" target="_blank">https://ask.openstack.org</a>) who happen to have been thinking<br>
about similar ideas, expanding Askbot capabilities beyond 'one' website.<br>
<br>
Evgeny here in cc sent me his thoughts about how Ask OpenStack could<br>
integrate with <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a> using 'widgets'. I invited him to join<br>
a wider discussion on the docs mailing list (keep him in the loop in the<br>
answers).<br>
<br>
> Below is a bit more detailed proposal for the widget feature.<br>
><br>
> The doc page in the right sidebar we could have a minimizable widget<br>
> (when minimized it would take a small sidebar strip and would be<br>
> displayed in muted style), when unfolded it could take say 50% of the<br>
> width.<br>
><br>
> Content of the widget would be a simplified version of the Askbot<br>
> layout, with just the content and the basic pages (question listing,<br>
> question details, login page - we'd have to create a stripped down<br>
> version for all pages used here).<br>
><br>
> Another use case could be - via inserting markers into the text of<br>
> the doc page where the questions are or around the paragraphs. When<br>
> you click on the marker - a corresponding question opens in the<br>
> sidebar. I.e. - questions can be tied to specific paragraphs, where<br>
> possible.<br>
><br>
> If a paragraph does not have questions - hovering over the text of<br>
> the doc page will display a prompt to "ask a question" about the<br>
> paragraph over which the pointer is hovering.<br>
><br>
> It could be useful to link authors of the page with the profiles in<br>
> the Q&A system, if they exist, in order to notify the authors of the<br>
> new questions.<br>
><br>
> On the "regular" forum question pages there would be "backlinks" to<br>
> the relevant doc pages.<br>
><br>
> Questions may be assigned/reassigned to one or more doc pages.<br>
<br>
What do you think?<br>
<br>
/stef<br>
<span class="HOEnZb"><font color="#888888"><br>
--<br>
Ask and answer questions on <a href="https://ask.openstack.org" target="_blank">https://ask.openstack.org</a><br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</font></span></blockquote></div><br><br clear="all"><br>-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div><div>Nimbis Services, Inc.</div><div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div>
</div>
</div></div></div>