[Openstack-docs] New Disqus look, doc comments

Anne Gentle anne at openstack.org
Mon Jul 23 13:30:59 UTC 2012


Great, thanks! Sign up at http://disqus.com/profile/signup/ and send
me the email address and I'll add you as moderator.

All the API guides currently use the openstackdocs shortname. I could
register another one and change the builds to use a new shortname if
we want, just let me know.
Thanks,
Anne

On Sun, Jul 22, 2012 at 8:53 PM, Ying Chun Guo <guoyingc at cn.ibm.com> wrote:
> Looks good to me !
> I'd like to be the moderators of those API related documents.
>
> Regards
> Ying Chun Guo (Daisy)
>
> Anne Gentle <anne at openstack.org> wrote on 07/21/2012 03:48:33 AM:
>
>> Anne Gentle <anne at openstack.org>
>> 07/21/2012 03:48 AM
>>
>> To
>>
>> openstack-docs at lists.openstack.org,
>>
>> cc
>>
>> Subject
>>
>> [Openstack-docs] New Disqus look, doc comments
>
>>
>> Hi all -
>>
>> You may have noticed that the "new-ish" RHEL and Ubuntu Install and
>> Deploy Guides have a slightly different display for the Disqus
>> Comments. For an example of the new comment UI, see [1].
>>
>> I can go through all the Disqus shortnames (such as [openstackdocs])
>> and upgrade the comments to this newer display. Does that sound good
>> to you all?
>>
>> For a little background, Disqus Identifiers are embedded into the
>> pom.xml file and the comments are inserted based on the xml:ID of each
>> section or chapter. I like to have a new Disqus shortname for each
>> book so that we can have moderators on the books they're most
>> interested in. The Disqus shortnames we have so far are:
>>
>> openstackdocs (used for all admin guides)
>> os-identitydevguide
>> os-apiquickstart
>> os-computeapiprogrammer
>> openstack-ha-guide
>> os-install-yum
>> os-install-apt
>> openstackstarterdoc
>> os-quantum-guides
>>
>> You can migrate comments from one xml:ID to another using the Disqus
>> comment migration tool.
>>
>> I have added some of you as moderators on comments and would be happy
>> to add more - this lets you set up notifications for the comments as
>> you like them.
>>
>> Let me know your thoughts on the new Disqus system so I can decide
>> whether we want to upgrade all our sites. When I requested new
>> shortnames for the new install/deploy guides, I got it automatically,
>> and it seems to be just fine.
>>
>> Thanks for the input!
>> Anne
>>
>> [1] http://docs.openstack.org/essex/openstack-compute/install/yum/
>> content/compute-configuring-guest-network.html#comment-593425339
>>
>> _______________________________________________
>> Openstack-docs mailing list
>> Openstack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>>
>
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>



More information about the Openstack-docs mailing list