Skip to content

Commit

Permalink
Rework landing pages for contributors and users
Browse files Browse the repository at this point in the history
* Add contributor personas
* Separate index page for user-only docs
* Fixes redhat-openstack#928
* First step towards fixing redhat-openstack#927
  • Loading branch information
pmkovar committed Jul 18, 2017
1 parent f67336b commit e97b8cc
Show file tree
Hide file tree
Showing 3 changed files with 93 additions and 85 deletions.
140 changes: 85 additions & 55 deletions source/contribute/index.html.md
Original file line number Diff line number Diff line change
@@ -1,108 +1,138 @@
---
title: Get involved
title: Contribute to RDO
category: community
authors: beni, dneary, mrunge, rbowen, strider, dmsimard
---

# Get involved
# Contribute to RDO

Help us make the RDO community site a great place for users and cloud operators in the Red Hat ecosystem by sharing your OpenStack questions and solutions on [ask.openstack](http://ask.openstack.org), and by adding [the most useful solutions](/troubleshooting/) and [user stories](/user-stories/) to the RDO website.
Help us make the RDO community site a great place for users and cloud operators in the Red Hat ecosystem. There are many ways to contribute to RDO, some of which are detailed below.

Our community strives to operate according to the terms of the
[OpenStack Code of Conduct](https://www.openstack.org/legal/community-code-of-conduct/).

1. toc
{:toc}
<div class="splits">
<div class="split-third with-more">

## Discuss
## Packager

Come chat in real-time with RDO users on **IRC** on the [Freenode](http://freenode.net) server:
* Review RDO patches
* Become an RDO package maintainer
* [Get started now!](/documentation/onboarding/){:.more}
{:.with-more-link}

* **#rdo**: Discussion around RDO in general ([Transcripts](http://eavesdrop.openstack.org/irclogs/%23rdo/))
* **#rdo-puppet**: Discussion around deploying RDO with Packstack and it's puppet modules
* **#openstack**: Discussion around OpenStack with the broader OpenStack community
* **#centos-devel**: Discussion around the CentOS [Cloud Special Interest Group (SIG)](https://wiki.centos.org/SpecialInterestGroup/Cloud)
</div>
<div class="split-third with-more">

We have weekly IRC meetings you can participate in:
## Tool developer

* [RDO meetings @ every Wednesday at 15:00 UTC on #rdo](/community/community-meeting)
* [CentOS Cloud SIG meetings @ every Thursday at 15:00 UTC on #centos-devel](/community/cloud-sig-meeting)
* [TripleO](https://docs.openstack.org/tripleo-docs/latest/contributor/)
* [Packstack](https://github.com/openstack/packstack)
* [Upstream Puppet Modules](https://docs.openstack.org/puppet-openstack-guide/latest/)
* [Kolla](https://github.com/openstack/kolla)

Join us for various [Events](/events/) around the world. [Organize your own meetup](/community/organize-a-meetup/). If you run a meetup group, or if you're speaking at a meetup [here's some of the ways we can help out](https://www.rdoproject.org/events/meetup_assistance/).
</div>
<div class="split-third">

## Stay informed
## Tester

Follow us on Twitter at [@rdocommunity](//twitter.com/rdocommunity), on [Google+](https://plus.google.com/communities/110409030763231732154), or on [Facebook](https://www.facebook.com/rdocommunity), as you prefer.
* [Review open bugs](https://bugzilla.redhat.com/buglist.cgi?product=RDO&query_format=advanced&bug_status=NEW&bug_status=ASSIGNED)
* [File bugs](https://bugzilla.redhat.com/enter_bug.cgi?product=RDO)
* [Participate in test days](/testday/)
* [Participate in doc days](/events/docdays/)

[Tweets by RDOcommunity](https://twitter.com/RDOcommunity){:.twitter-timeline data-widget-id="482610699122638848" data-height="425"}
<script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src='//platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
</div>
</div>

Join our [newsletter mailing list](//www.redhat.com/mailman/listinfo/rdo-newsletter) for monthly updates on RDO and the larger OpenStack world.
<div class="splits">
<div class="split-third with-more">

Watch [RDO videos](/rdo/rdo-videos). These include recorded talks, meetups, and other community events.
## People person

## Ask and answer
* [Join the RDO mailing lists](/community/mailing-lists)
* Chat on #rdo on Freenode
* [Participate in weekly meetings](/community/community-meeting)
* [Join upcoming events](/events)
* [More&hellip;](#discuss){:.more}
{:.with-more-link}

- Check our [Frequently Asked Questions (FAQ) page](/rdo/faq/) for answers to common questions
- Try our [troubleshooting page](/troubleshooting/) for solutions to common problems
- Join the ask.openstack community to ask and answer questions:
</div>
<div class="split-third with-more">

The site [ask.openstack](http://ask.openstack.org) is the upstream Q&A for all manner of OpenStack issues.
## Content writer

- Search [ask.openstack](http://ask.openstack.org) to find previous discussions on the topic.
- If you ask a new question, consider adding the tag “rdo” to it. You can use [this link to add a new question with this tag](https://ask.openstack.org/en/questions/ask/?tags=rdo).
- [Find all questions on ask.openstack related to RDO](https://ask.openstack.org/en/questions/scope:all/sort:age-desc/page:1/query:rdo/).
- If you're a frequent poster on ask.openstack and wish to identify yourself as part of the RDO community, consider adding the RDO logo to your avatar, like Lars: [https://ask.openstack.org/en/users/1745/larsks/](https://ask.openstack.org/en/users/1745/larsks/) .
* [Participate in doc days](/events/docdays/)
* [Work on RDO website issues](https://github.com/redhat-openstack/website/issues)
* [More&hellip;](#write-content){:.more}
{:.with-more-link}

- Help improve our knowledge base by turning the best answers to questions on the [mailing lists](/community/mailing-lists/) or on [ask.openstack.org](http://ask.openstack.org) into a page in our [troubleshooting section](/troubleshooting/). In case of ask.openstack.org, a link might be sufficient.
- Blog about how you're using RDO. If you blog frequently about RDO and OpenStack, consider [requesting that your blog be added](https://wiki.openstack.org/wiki/AddingYourBlog) to the upstream [Planet OpenStack](http://planet.openstack.org/).
- [Fork the website on Github](https://github.com/redhat-openstack/website) and help us improve our documentation.
</div>
<div class="split-third">

## User

* Share questions and solutions on [ask.openstack](https://ask.openstack.org/en/questions/scope:all/sort:age-desc/page:1/query:rdo/)
* Add [the most useful solutions](/troubleshooting/)
* Submit your [user stories](/user-stories/)
* [More&hellip;](#ask-and-answer){:.more}
{:.with-more-link}

</div>
</div>

## Report
<a name="discuss"/>

An important way that you can contribute to RDO is by reporting any
problems you encounter.
## Discuss

To file bugs against RDO, use the [RDO bugzilla](https://bugzilla.redhat.com/enter_bug.cgi?product=RDO).
Come chat in real-time with RDO users on **IRC** on the [Freenode](http://freenode.net) server:

To report problems with this website, use the [tracker on
GitHub](https://github.com/redhat-openstack/website/issues).
* **#rdo**: Discussion around RDO in general ([transcripts](http://eavesdrop.openstack.org/irclogs/%23rdo/))
* **#rdo-puppet**: Discussion around deploying RDO with Packstack and it's puppet modules
* **#openstack**: Discussion around OpenStack with the broader OpenStack community
* **#centos-devel**: Discussion around the CentOS [Cloud Special Interest Group (SIG)](https://wiki.centos.org/SpecialInterestGroup/Cloud)

If you're not sure where the problem likes
[ask.openstack.org](http://ask.openstack.org/) is the best place to
start.
We have weekly IRC meetings you can participate in:

## Contribute
* [RDO meetings @ every Wednesday at 15:00 UTC on #rdo](/community/community-meeting)
* [CentOS Cloud SIG meetings @ every Thursday at 15:00 UTC on #centos-devel](/community/cloud-sig-meeting)

RDO is a large community interested in packaging and deploying [OpenStack](http://www.openstack.org) on RHEL and its derivatives.
Join us for various [events](/events/) around the world. [Organize your own meetup](/community/organize-a-meetup/). If you run a meetup group, or if you're speaking at a meetup [here's some of the ways we can help out](https://www.rdoproject.org/events/meetup_assistance/).

We can always use your feedback and contributions to make RDO better.
<a name="ask-and-answer"/>

### Packaging
## Ask and answer

Get started by looking at the [RDO packaging documentation](/documentation/rdo-packaging), taking a glance at our [packages](https://github.com/rdo-packages) and help with [patch reviews](https://review.rdoproject.org/r/#/q/status:open+project:%255Eopenstack.*,n,z).
- Check our [Frequently Asked Questions (FAQ) page](/rdo/faq/) for answers to common questions
- Try our [troubleshooting page](/troubleshooting/) for solutions to common problems
- Watch [RDO videos](/rdo/rdo-videos). These include recorded talks and community events.
- Help improve our knowledge base by turning the best answers to questions on the [mailing lists](/community/mailing-lists/) or on [ask.openstack.org](http://ask.openstack.org) into a page in our [troubleshooting section](/troubleshooting/). In case of ask.openstack.org, a link might be sufficient.
- Blog about how you're using RDO. If you blog frequently about RDO and OpenStack, consider [requesting that your blog be added](https://wiki.openstack.org/wiki/AddingYourBlog) to the upstream [Planet OpenStack](http://planet.openstack.org/).
- [Fork the website on Github](https://github.com/redhat-openstack/website) and help us improve our documentation.

### Installers
### Join ask.openstack

Packages provided by RDO to install and configure OpenStack are available through several projects which could all use your help:
Join the ask.openstack community to ask and answer questions. The site [ask.openstack](http://ask.openstack.org) is the upstream Q&A for all manner of OpenStack issues.

* [Packstack](https://github.com/openstack/packstack)
* [Packaged openstack-puppet-modules](https://github.com/redhat-openstack/openstack-puppet-modules) and [upstream Puppet Modules](https://wiki.openstack.org/wiki/Puppet)
* [Triple-O](https://wiki.openstack.org/wiki/TripleO)
* [Kolla](https://github.com/openstack/kolla)
- Search [ask.openstack](http://ask.openstack.org) to find previous discussions on the topic.
- If you ask a new question, consider adding the tag “rdo” to it. You can use [this link to add a new question with this tag](https://ask.openstack.org/en/questions/ask/?tags=rdo).
- [Find all questions on ask.openstack related to RDO](https://ask.openstack.org/en/questions/scope:all/sort:age-desc/page:1/query:rdo/).
- If you're a frequent poster on ask.openstack and wish to identify yourself as part of the RDO community, consider adding the RDO logo to your avatar, like Lars: [https://ask.openstack.org/en/users/1745/larsks/](https://ask.openstack.org/en/users/1745/larsks/) .

<a name="write-content"/>

### Docs and website
## Content writing

Help improve the documentation and website! The main pages for contributed content are [documentation](/documentation/), [troubleshooting](/troubleshooting/) and [user stories](/user-stories/).

* Take a look at the open issues list: [https://github.com/redhat-openstack/website/issues](https://github.com/redhat-openstack/website/issues)
* Update this or another page by submitting pull requests to the [https://github.com/redhat-openstack/website](https://github.com/redhat-openstack/website) repo, or by clicking the `Edit on Github` banner at the top right.
* Fork the whole website: [https://github.com/redhat-openstack/website](https://github.com/redhat-openstack/website)

### Writing guidelines

Here are a few guidelines for contributing new content to the website:

* Please [search](/search/) first to check if there is a similar page which you can update.
* Use normal English case for page names. [Get involved](/community/) is correct, [Get Involved](/community/) is not.
* Please keep the website content connected! When you add a new page, add a link to it from the appropriate page(s).
* Please be aware of our [terms of use](/legal/terms-of-use/) — among other things, you agree to license your contributions under the [Creative Commons Attribution License version 3.0](http://creativecommons.org/licenses/by/3.0/), and you agree not to submit illegal content.

12 changes: 6 additions & 6 deletions source/index.html.haml
Original file line number Diff line number Diff line change
Expand Up @@ -69,13 +69,13 @@ hide_metadata: true
Try out OpenStack in one of three ways:
%p.lead
Spin up an all-in-one concept cloud with
=link_to("Packstack", "/install/packstack/")
=link_to("Packstack.", "/install/packstack/")
%p.lead
Deploy a production cloud with
=link_to("TripleO", "http://tripleo.org/")
Deploy a production cloud with
=link_to("TripleO.", "http://tripleo.org/")
%p.lead
Develop and Test OpenStack with
=link_to("TripleO Quickstart", "/tripleo")
Develop and test OpenStack with
=link_to("TripleO Quickstart.", "/tripleo")

.col-md-4
.block-heading
Expand Down Expand Up @@ -106,7 +106,7 @@ hide_metadata: true
%p.lead
On the
=link_to("mailing lists,", "/community/mailing-lists")
on #RDO on the Freenode IRC network,
on #rdo on the Freenode IRC network,
and on
=link_to("ask.openstack.org.", "http://ask.openstack.org")

Expand Down
26 changes: 2 additions & 24 deletions source/use/index.html.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: Docs
title: Use RDO
category: documentation
authors: admin, apevec, awheeler, ccrouch, dansmith, dneary, fale, garrett, jlibosva,
jruzicka, larsks, marafa, otherwiseguy, pixelbeat, pmyers, radez, rbowen, rkukura,
rossturk, sdake, sgordon, shardy, strider, thoraxe
---

# RDO documentation
# RDO for users

Since RDO sticks closely to the upstream OpenStack project, the documentation at [docs.openstack.org](http://docs.openstack.org) will also prove helpful. If you've come across useful tips for resolving issues on OpenStack, or if you're interested in sharing details of your deployment, please consider sharing this information with the community at our [troubleshooting](/troubleshooting/) and [user stories](/user-stories/) pages.

Expand Down Expand Up @@ -68,28 +68,6 @@ Since RDO sticks closely to the upstream OpenStack project, the documentation at
</div>
</div>

## Development

<div class="splits">
<div class="split-third with-more">

### Packaging

* [RDO Packager guide](/documentation/rdo-packaging)

</div>
<div class="split-third">

### Testing

* [RDO test days](/testday) &ndash; trying a pre-release
* [RDO trunk development](https://trunk.rdoproject.org/)
* [Open
tickets](https://bugzilla.redhat.com/buglist.cgi?product=RDO&query_format=advanced&bug_status=NEW&bug_status=ASSIGNED)

</div>
</div>

## Upstream documentation

* [OpenStack docs](http://docs.openstack.org/)
Expand Down

0 comments on commit e97b8cc

Please sign in to comment.