<div dir="ltr"><div dir="ltr">On Mon, Apr 6, 2020 at 4:03 PM Ghanshyam Mann <<a href="mailto:gmann@ghanshyammann.com">gmann@ghanshyammann.com</a>> wrote:<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">---- On Mon, 06 Apr 2020 10:36:49 -0500 Donny Davis <<a href="mailto:donny@fortnebula.com" target="_blank">donny@fortnebula.com</a>> wrote ----<br>
 > On Mon, Apr 6, 2020 at 11:22 AM Artom Lifshitz <<a href="mailto:alifshit@redhat.com" target="_blank">alifshit@redhat.com</a>> wrote:<br>
 > On Sat, Apr 4, 2020 at 9:12 PM Ghanshyam Mann <<a href="mailto:gmann@ghanshyammann.com" target="_blank">gmann@ghanshyammann.com</a>> wrote:<br>
 > ><br>
 > > This topic is a very important and critical area to solve in the OpenStack community.<br>
 > > I personally feel and keep raising this issue wherever I get the opportunity.<br>
 > ><br>
 > > To develop or maintain any software, the very first thing we need is to have enough developer resources.<br>
 > > Without enough developers (either open or closed source), none of the software can survive.<br>
 > ><br>
 > > OpenStack current situation on contributors is not the same as it was few years back.  Almost every<br>
 > > project is facing the less contributor issue as compare to requirements and incoming requests. Few<br>
 > > projects already dead or going to be if we do not solve the less contributors issue now.<br>
 > ><br>
 > > I know, TC is not directly responsible to solve this issue but we should do something or at least find<br>
 > > the way who can solve this.<br>
 > <br>
 > I'm not running for TC, but I figured I could chime in with some<br>
 > thoughts, and maybe get TC candidates to react.<br>
 > <br>
 > > What do you think about what role TC can play to solve this? What platform or entity can be used by TC to<br>
 > > raise this issue? or any new crazy Idea?<br>
 > <br>
 > To my knowledge, the vast majority of contributors to OpenStack are<br>
 > corporate contributors - meaning, they contribute to the community<br>
 > because it's their job. As companies have dropped out, the contributor<br>
 > count has diminished. Therefore, the obvious solution to the<br>
 > contributor dearth would be to recruit new companies that use or sell<br>
 > OpenStack. However, as far as I know, Red Hat is the only company<br>
 > remaining that still makes money from selling OpenStack as a product.<br>
 > So if we're looking for new contributor companies, we would have to<br>
 > look to those that use OpenStack, and try to make the case that it<br>
 > makes sense for them to get involved in the community. I'm not sure<br>
 > what this kind of advocacy would look like, or towards which<br>
 > companies, or what kind of companies, it would be directed. Perhaps<br>
 > the TC candidates could have suggestions here. And if I've made any<br>
 > wrong assumptions, by all means correct me.<br>
 > <br>
 > ><br>
 > > -gmann<br>
 > ><br>
 > <br>
 > <br>
 > <br>
 > I don't think you are too far off.  I used to work in a place where my job was to help sell Openstack (among other products) andenable the use of it with customers.<br>
 > Customers drive everything vendors do. Things that sell are easy to use. Customers don't buy the best products, they buy what theycan understand fastest. If customers are asking for a product, it's because they understand its value. Vendors in turn contributeto projects because they make money from their investment.<br>
 > Now think about the perception and reality of Openstack as a whole. We have spent the last decade or so writing bleeding edge features.We have spent very little time on documenting what we do have in layman's terms. The intended audience of our docs would seemto me to be other developers. I hope people don't take that as a jab, it's just the truth. If someone cannot understand how to usethis amazing technology, it won't sell. If it doesn't sell, vendors leave, if vendors leave the number of contributors goes down.<br>
 > If we don't start working at making Openstack easier to consume, then no amount of technical change will make an impactful difference.<br>
<br>
Ok, this is one of the key things and I am 100% agree on your point - "our docs would seem to me to be other developers".<br>
Does this include 'feature doc & how to use them' or overall usage of OpenStack like "Project X and Y can solve the use case<br>
Z" (what Radosław mentioned in this reply) ? <br>
<br>
As you might know, our documentation team is lacking active contributors and moving towards SIG and almost all the documents<br>
are moved/maintain on project side. Do you think that is the issue and can make the current doc more worst (with the typical developer nature)?  <br>
<br>
Again the same question is here, 'How to get the documents contributors ?' Can operators help here with their use cases, best practice etc ?<br>
If so then how to convince them to participate and contribute in the community?<br>
<br>
-gmann<br>
<br>
<br>
 > <br>
 > -- <br>
 > ~/DonnyDC: 805 814 6800"No mission too difficult. No sacrifice too great. Duty First"<br>
</blockquote></div><br clear="all"><div><br></div><div>Our docs team is completely overloaded. There is no way I see them having the capacity to come up with something. We need a team of</div><div>operators who know how operators read, think and talk to put together a consumable document pointed directly at other would be operators / </div><div>potential new adopters.  We need to target new users who don't know anything about Openstack or in many cases cloud in general. </div><div>These Operators don't need to know all the switches and knobs they *can* turn in Openstack when they are in the learning phase. </div><div>The ones that do, already know how it all works anyways and the current doc set works great for them. </div><div></div><div><br></div><div>How do we get contributors to this doc - well I don't really have the answer for that. It's not going to be easy to say the least. </div><div>Maybe put out a marketing campaign to find Operators who are willing to contribute.</div><div><br></div><div>It's also not just docs - because anyone who has been in IT for more than 12 seconds knows many people don't / won't read docs. </div><div>Maybe a simple to understand video series would be super helpful to get people off the ground. </div><div><br></div><div>I really don't have all the answers, but I do know for sure that building a cloud is hard - so let's make it easier. </div><div><br></div>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div>~/DonnyD</div><div>C: 805 814 6800</div><div>"No mission too difficult. No sacrifice too great. Duty First"</div></div></div></div>