I'm cool with the existing keystone repo and adding to docs. If we hit a huge amount of content then we can migrate to a new repo. I think Adam's main concern with this approach is that we reduce the contributors down to folks that know the gerrit workflow.
On Tue, Jun 28, 2016 at 8:19 PM, Jamie Lennox <jamielen...@gmail.com> wrote: > > > On 29 June 2016 at 09:49, Steve Martinelli <s.martine...@gmail.com> wrote: > >> I think we want something a bit more organized. >> >> Morgan tossed the idea of a keystone-docs repo, which could have: >> >> - The FAQ Adam is asking about >> - Install guides (moved over from openstack-manuals) >> - A spot for all those neat and unofficial blog posts we do >> - How-to guides >> - etc... >> >> I think it's a neat idea and warrants some discussion. Of course, we >> don't want to be the odd project out. >> > > What would be the advantage of a new repo rather than just using the > keystone/docs folder. My concern is that docs/ already gets stagnate but a > new repo would end up being largely ignored and at least theoretically you > can update docs/ when the relevant code changes. > > >> >> On Tue, Jun 28, 2016 at 6:00 PM, Ian Cordasco <sigmaviru...@gmail.com> >> wrote: >> >>> -----Original Message----- >>> From: Adam Young <ayo...@redhat.com> >>> Reply: OpenStack Development Mailing List (not for usage questions) >>> <openstack-dev@lists.openstack.org> >>> Date: June 28, 2016 at 16:47:26 >>> To: OpenStack Development Mailing List < >>> openstack-dev@lists.openstack.org> >>> Subject: [openstack-dev] Troubleshooting and ask.openstack.org >>> >>> > Recently, the Keystone team started brainstormin a troubleshooting >>> > document. While we could, eventually put this into the Keystone repo, >>> > it makes sense to also be gathering troubleshooting ideas from the >>> > community at large. How do we do this? >>> > >>> > I think we've had a long enough run with the ask.openstack.org website >>> > to determine if it is really useful, and if it needs an update. >>> > >>> > >>> > I know we getting nuked on the Wiki. What I would like to be able to >>> > generate is Frequently Asked Questions (FAQ) page, but as a living >>> > document. >>> > >>> > I think that ask.openstack.org is the right forum for this, but we >>> need >>> > some more help: >>> > >>> > It seems to me that keystone Core should be able to moderate Keystone >>> > questions on the site. That means that they should be able to remove >>> > old dead ones, remove things tagged as Keystone that do not apply and >>> so >>> > on. I would assume the same is true for Nova, Glance, Trove, Mistral >>> > and all the rest. >>> > >>> > We need some better top level interface than just the tags, though. >>> > Ideally we would have a page where someone lands when troubleshooting >>> > keystone with a series of questions and links to the discussion pages >>> > for that question. Like: >>> > >>> > >>> > I get an error that says "cannot authenticate" what do I do? >>> > >>> > What is the Engine behind "ask.openstack.org?" does it have other >>> tools >>> > we could use? >>> >>> The engine is linked in the footer: https://askbot.com/ >>> >>> I'm not sure how much of it is reusable but it claims to be able to do >>> some of the things I think you're asking for except it doesn't >>> explicitly mention deleting comments/questions/etc. >>> >>> -- >>> Ian Cordasco >>> >>> >>> __________________________________________________________________________ >>> OpenStack Development Mailing List (not for usage questions) >>> Unsubscribe: >>> openstack-dev-requ...@lists.openstack.org?subject:unsubscribe >>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >>> >> >> >> __________________________________________________________________________ >> OpenStack Development Mailing List (not for usage questions) >> Unsubscribe: >> openstack-dev-requ...@lists.openstack.org?subject:unsubscribe >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev >> >> > > __________________________________________________________________________ > OpenStack Development Mailing List (not for usage questions) > Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev > >
__________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
