Open Stack

On Thu, Oct 31, 2013 at 12:59 PM, Steve Gordon <sgordon at redhat.com> wrote:

> ----- Original Message -----
> > From: "Anne Gentle" <annegentle at justwriteclick.com>
> > To: "David Cramer" <david.cramer at rackspace.com>
> > Cc: "openstack-docs at lists.openstack.org" <
> Openstack-docs at lists.openstack.org>, "Evgeny Fadeev"
> > <evgeny.fadeev at gmail.com>
> > Sent: Thursday, October 31, 2013 12:53:13 PM
> > Subject: Re: [Openstack-docs] Integrating Ask OpenStack in docs
> >
> > Yes, these and other down sides:
> >
> > Disqus is proprietary software.
> > Disqus terms of service definitely spook off open source contributors who
> > tend to have a higher concern around data sharing, ads. [1]
> > Disqus automatically changed settings last year to monetization settings
> > which I had to manually change for each site ID.
> > Disqus RSS feed is no longer available without a login.
>
> I can answer a few of these based on my use of the site:
>
> > I do have implementation requests for the replacement.
> > - Can you embed code snippets?
>
> Yes, using markdown (indent four spaces or surround in tildas, there is
> also a button on the WYSIWYG editor).
>
> > - Does it provide spam/robot protection?
> > - Can we "bulk close" or expire threads that are opened at a specific
> point
> > in time? For example, closing all moderation and asking on the Diablo or
> > Folsom releases.
>
> Is there a particular driver for wanting to do this other than that the
> documentation wouldn't be updated? My thinking is we'd just turn off our
> notifications on these (might be a requirement for more advanced tag
> filtering, more on that below), if the community is still asking (and
> answering) questions on these then I don't think they should be treated
> differently to any other question on ask.o.o - though ther eis a closure
> reason for "not relevant or outdated".
>

I'm just trying to be sure we focus on supported releases --
https://wiki.openstack.org/wiki/Releases


>
> > - Can we have RSS notification, text notification, email notifications
> when
> > a new thread is started, when one gets a reply, for an entire book?
>
> An RSS feed is automatically created for all tags, email notifications are
> available (instant, daily digest, weekly digest, or none) and you would
> configure them based on the tags of interest as well. From the UI it's not
> clear to me how you would configure email notification based on a
> combination of tags (for instance "install-guide" + "yum" + "neutron", but
> not "install-guide" + "apt" + "neutron", or even something like
> "install-guide" + "yum" - "diablo").
>
> Ultimately all notification related questions really come back to what
> tags are used when raising a question from the documentation and what
> filtering can be exposed by ask when generating the existing RSS feeds and
> emails.


> > - Can notifications be controlled by group or by individual users only?
> > - Will the mobile user experience be supported?
>
> ask.o.o seems to work OK on mobile (actually better than
> docs.openstack.org - are we meant to be exposing a mobile specific
> version of the site?).
>

That's great. We haven't ever done work on a mobile experience for
docs.openstack.org. My hope is that Todd Morey's redesign would be better
at that.


>
> > - Can we have analytics reports available on which pages are generating
> the
> > most questions, hotly debated, what time of day do they occur, how long
> > does it take for someone to respond?
> > - Will we be able to moderate the threads by closing down a thread or
> > deleting a reply completely?
>
> As you earn points on the ask.o.o site you gain moderator abilities, 500
> is the threshold for being able to delete content. Part of the idea in
> these systems is that as users gain points they are guided on how to best
> use their powers as they are granted.
>
>
Ok, this might work out for the best. I still somewhat prefer to have
someone responsible as a topic moderator for a book, but that person should
be good on the selected topics of the book, so I think this should work
out.

Thanks for all the info, Steve!

Anne


> Thanks,
>
> Steve
>



-- 
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20131031/2a6a9e77/attachment.html>