11:54 a.m.
We use the term "Quickstart" in a number of different ways in our
documentation. Primarily, we use it to refer to the TripleO and
Packstack "quick" installation methods.
Long ago, when the world was young, Quickstart referred only to
Packstack. We then had a variety of Quickstart variant docs, most of
which are gone now. Then we did the TripleO Quickstart.
This ticket: https://github.com/redhat-openstack/website/issues/931 -
and this one - https://github.com/redhat-openstack/website/issues/924 -
discuss clarifying this, and using the term "Quickstart" only to refer
to the TripleO Quickstart.
I wanted to be sure that this conversation is seen by more people, so
that we're framing this in a way that both makes sense to beginners, and
correctly reflects the direction we want to go with this as a project.
So, we have:
* Packstack: For an all-in-one proof of concept cloud
* TripleO Quickstart: (How do we want to advertise this?)
* TripleO.org: For actual real-world production deployments
Yes? Comments?
--
Rich Bowen - rbowen(a)redhat.com
RDO Community Liaison
http://rdoproject.org
@RDOCommunity
12:11 p.m.
* Packstack: For an all-in-one proof of concept cloud
* TripleO Quickstart: (How do we want to advertise this?)
* TripleO.org: For actual real-world production deployments
Yes? Comments?
Yes! I liked the wording in
https://github.com/redhat-openstack/website/issues/924#issuecomment-30676...
let's start with that:
Spin up an all-in-one concept cloud with Packstack (links to packstack page)
Deploy a production cloud with the TripleO (links to tripleo.org)
Develop and Test OpenStack with the TripleO Quickstart tool (links to
tripleoQS page)
I would just drop tool names, since in the future we might come up
with different tooling for each use-case:
Spin up an all-in-one concept cloud (links to packstack page)
Deploy a production cloud (links to tripleo.org)
Develop and test OpenStack (links to tripleoQS page)
Cheers,
Alan
12:16 p.m.
On 06/09/2017 01:11 PM, Alan Pevec wrote:
> * Packstack: For an all-in-one proof of concept cloud
> * TripleO Quickstart: (How do we want to advertise this?)
> * TripleO.org: For actual real-world production deployments
> Yes? Comments?
Yes! I liked the wording in
https://github.com/redhat-openstack/website/issues/924#issuecomment-30676...
let's start with that:
Spin up an all-in-one concept cloud with Packstack (links to packstack page)
Deploy a production cloud with the TripleO (links to tripleo.org)
Develop and Test OpenStack with the TripleO Quickstart tool (links to
tripleoQS page)
That change is already in place on the front page. So I was looking for
further buy-in before we make broader changes across the site.
I would just drop tool names, since in the future we might come up
with different tooling for each use-case:
Spin up an all-in-one concept cloud (links to packstack page)
Deploy a production cloud (links to tripleo.org)
Develop and test OpenStack (links to tripleoQS page)
And #931 also involves changing the URL path to reflect this new
phrasing, too, which is more involved. As I say in that ticket, I'm a
big fan of URLs reflecting the way we want people to think about things.
And our current site is a bit of a jumble when it comes to sane URLs.
Anyways, thanks for the feedback and confirmation. I look forward to
hearing from others also.
--
Rich Bowen - rbowen(a)redhat.com
RDO Community Liaison
http://rdoproject.org
@RDOCommunity
4:22 p.m.
On Fri, Jun 9, 2017 at 1:16 PM, Rich Bowen <rbowen(a)redhat.com> wrote:
On 06/09/2017 01:11 PM, Alan Pevec wrote:
>> * Packstack: For an all-in-one proof of concept cloud
>> * TripleO Quickstart: (How do we want to advertise this?)
>> * TripleO.org: For actual real-world production deployments
>
>> Yes? Comments?
>
> Yes! I liked the wording in
> https://github.com/redhat-openstack/website/issues/924#issuecomment-30676...
> let's start with that:
>
> Spin up an all-in-one concept cloud with Packstack (links to packstack page)
> Deploy a production cloud with the TripleO (links to tripleo.org)
> Develop and Test OpenStack with the TripleO Quickstart tool (links to
> tripleoQS page)
That change is already in place on the front page. So I was looking for
further buy-in before we make broader changes across the site.
+1
> I would just drop tool names, since in the future we might come
up
> with different tooling for each use-case:
>
> Spin up an all-in-one concept cloud (links to packstack page)
> Deploy a production cloud (links to tripleo.org)
> Develop and test OpenStack (links to tripleoQS page)
>
And #931 also involves changing the URL path to reflect this new
phrasing, too, which is more involved. As I say in that ticket, I'm a
big fan of URLs reflecting the way we want people to think about things.
And our current site is a bit of a jumble when it comes to sane URLs.
Anyways, thanks for the feedback and confirmation. I look forward to
hearing from others also.
The current versions of https://www.rdoproject.org and
https://www.rdoproject.org/tripleo with the above change look great.
IMO: Decoupling "quickstart" from "packstack" will help the
confusion.
If all instances of the word "quickstart" could be replaced by
"packstack" in the following page I think it would help:
https://www.rdoproject.org/install/quickstart
I would even change the URL from /install/quickstart to
/install/packstack and I think /install/quickstart shouldn't even
redirect.
Similarly, I'm all for removing the phrase "packstack quickstart" from
https://www.rdoproject.org/install .
Thanks,
John
10:29 a.m.
On 06/09/2017 05:22 PM, John Fulton wrote:
IMO: Decoupling "quickstart" from "packstack" will help the
confusion.
If all instances of the word "quickstart" could be replaced by
"packstack" in the following page I think it would help:
https://www.rdoproject.org/install/quickstart
I would even change the URL from /install/quickstart to
/install/packstack and I think /install/quickstart shouldn't even
redirect.
Similarly, I'm all for removing the phrase "packstack quickstart" from
https://www.rdoproject.org/install .
Thanks for the feedback folks. I'll get started on these changes soon
unless someone beats me to it.
--
Rich Bowen - rbowen(a)redhat.com
RDO Community Liaison
http://rdoproject.org
@RDOCommunity
10:54 a.m.
Rich,
thanks for this. I am a keen documenter but do not know enough of the
system to help edit. However, I can test instructions for both all-in-one
(1 x ethernet port) and packstack (using 2 x ethernet ports) with the
latter using a generated answers.txt file which I know how to edit.
Regards,
Phill.
On 12 June 2017 at 16:29, Rich Bowen <rbowen(a)redhat.com> wrote:
On 06/09/2017 05:22 PM, John Fulton wrote:
>
> IMO: Decoupling "quickstart" from "packstack" will help the
confusion.
> If all instances of the word "quickstart" could be replaced by
> "packstack" in the following page I think it would help:
> https://www.rdoproject.org/install/quickstart
>
> I would even change the URL from /install/quickstart to
> /install/packstack and I think /install/quickstart shouldn't even
> redirect.
>
> Similarly, I'm all for removing the phrase "packstack quickstart"
from
> https://www.rdoproject.org/install .
Thanks for the feedback folks. I'll get started on these changes soon
unless someone beats me to it.
--
Rich Bowen - rbowen(a)redhat.com
RDO Community Liaison
http://rdoproject.org
@RDOCommunity
_______________________________________________
rdo-list mailing list
rdo-list(a)redhat.com
https://www.redhat.com/mailman/listinfo/rdo-list
To unsubscribe: rdo-list-unsubscribe(a)redhat.com
2521
days inactive
2524
days old
5 comments
4 participants
participants (4)
-
Alan Pevec -
John Fulton -
Phill. Whiteside -
Rich Bowen