Open Stack

Hi Stef,

Yes that's what I had in mind - use a similar method for embedding
the widget as Discus does.

As long as there is a unique identifier of a page, there won't be a problem
of attaching questions to them. We could also later think of other methods
based on hashes of content.

Best regards,
Evgeny.





On Thu, Oct 31, 2013 at 9:44 PM, Stefano Maffulli <stefano at openstack.org>wrote:

> On 10/31/2013 04:35 PM, Tom Fifield wrote:
> > On 01/11/13 10:30, Stefano Maffulli wrote:
> >> Docs team: how can we get a unique identifier for each page (and its
> >> version) hosted on docs.openstack.org?
> >
> > We have that already in the doc - each doc knows what version it is, and
> > it knows what section it is. This is used today by disqus.
>
> After an exchange on IRC to clarify this sentence, I think that we can
> safely say that we can pass any variable we want from any place in the
> documentation to the to-be-built askbot widgets. For example, currently
> the build toolchain for docs passes to Disqus things like:
>
>   var disqus_shortname = 'os-install-apt';
>   var disqus_identifier = 'openstack-install-manual-grizzlych_neutron';
>
>  there's also vars like:
>
>     var bugTitle = "Chapter 9. Installing OpenStack Networking Service
> in OpenStack Installation Guide for Ubuntu 12.04 (LTS)  - havana";
>     var gitSha = "git SHA: 194f5e8d0cb7cddb1b567de9bba61539540c615d";
>     var xmlId = "xml:id: ch_neutron"
>     var sourceFile = "source File:
>
> file:/home/jenkins/workspace/openstack-install-deploy-guide-ubuntu/doc/install-guide/ch_neutron.xml"
>
> and similar things.
>
> Short answer: we can build from the toolchain a system to bind askbot
> questions/answers to askbot.
>
> Evgeny: does this inspire you to design the embeddable widget so that it
> responds to the use case mentioned before?
>
> thanks,
> Stef
>
> --
> Ask and answer questions on https://ask.openstack.org
>



-- 
Askbot
Valparaiso, Chile
skype: evgeny-fadeev
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20131104/9fbd0a2c/attachment.html>