<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Sep 10, 2014 at 7:33 PM, Stefano Maffulli <span dir="ltr"><<a href="mailto:stefano@openstack.org" target="_blank">stefano@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><span class="">On 09/10/2014 11:49 AM, Rochelle.RochelleGrober wrote:<br>
> [Rocky Grober] Some parts of the developer documents will be useful<br>
> for enduser developers, such as the API docs (which really are for<br>
> all developers in/on OpenStack), but many of the documents are<br>
> specifically focused on OpenStack *code* developers.  I think<br>
> Endusers, Operators and Docs teams need to work to determine which<br>
> docs belong where, and with links to the main pages where the other<br>
> OpenStack documents live (with a short description of the focus of<br>
> those other document libraries).  For instance, I don't really see<br>
> the Gerrit Workflow document being particularly useful for the<br>
> enduser community.<br>
<br>
</span>I haven't conveyed my thoughts clearly. I'll try again.<br>
<br>
1) I noticed that the word "developer" appears on<br>
<a href="http://developer.OpenStack.org" target="_blank">http://developer.OpenStack.org</a> and on <a href="http://docs.OpenStack.org/developer" target="_blank">http://docs.OpenStack.org/developer</a></blockquote><div><br></div><div>Yep, and I like the way <a href="http://developer.mozilla.org">developer.mozilla.org</a> handles it with a single landing page. </div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><br>
2) <a href="http://developer.Mozilla.org" target="_blank">developer.Mozilla.org</a> referenced as an example clearly caters for all<br>
sorts of different 'developers' (from Firefox to Firefox OS to html5<br>
apps to tools and more...)<br>
<br>
Since:<br>
- we all seem to agree that the word 'developer' means different things<br>
in different contexts and<br>
- well designed information flow can help the readers select their own<br>
paths based on their own needs, and<br>
- <a href="http://Docs.openstack.org" target="_blank">Docs.openstack.org</a> is being redesigned and<br>
- currently <a href="http://developer.openstack.org" target="_blank">developer.openstack.org</a> is pretty much a static page with<br>
curated links to outside resources<br>
<br>
I don't think it's inappropriate to give a serious thought to widening<br>
the scope of the portal <a href="http://developers.openstack.org" target="_blank">developers.openstack.org</a>.<br>
<br></blockquote><div><br></div><div>Sure, and yes, we do need the redesign work to integrate all the subsites but especially these two.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
It's with that in mind, and with the wider picture of a re-design of<br>
<a href="http://Docs.openstack.org" target="_blank">Docs.openstack.org</a> that I suggest thinking holistically.<br>
<br>
We may want to continue this conversation on another list though as I<br>
think it may be off-topic here.<br>
<div class=""><div class="h5"><br></div></div></blockquote><div><br></div><div>Yeah it's really tough to do info design on a mailing list. But I did want to pipe in with a few thoughts. </div><div><br></div><div>I went to lunch with one of the community managers at Mozilla just the other week. (Fun fact: she is the one who pointed out the OpenStack job to me four years ago.) I often pick her brain about how they are doing content development as well as how they are building developer communities. So I know a LOT about how <a href="http://developer.mozilla.org">developer.mozilla.org</a> is put together and yes there are parallels in their different developers and OpenStack's varied developers. The most interesting parallel is in their trying to get devs to write apps for their phone platform. They found that Africa (Tunisia perhaps?) was their central geo-location for the most activity on their phone platform. They've done a lot with local ambassador programs for app devs. </div><div><br></div><div>We need to ask our super users to tell us the best apps they're supporting. We need to discover the people doing this "walk then talk" developer advocacy: <a href="https://medium.com/@romannurik/walk-then-talk-3b935bfe5484">https://medium.com/@romannurik/walk-then-talk-3b935bfe5484</a> </div><div><br></div><div>Everett's for sure doing the walk-n-talk, let's keep gathering community members who walk-n-talk. :) And let's get info they need in a great design - info and web both.</div><div>Thanks,</div><div>Anne </div><div><br></div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div class=""><div class="h5">
/stef<br>
<br>
--<br>
Ask and answer questions on <a href="https://ask.openstack.org" target="_blank">https://ask.openstack.org</a><br>
<br>
_______________________________________________<br>
User-committee mailing list<br>
<a href="mailto:User-committee@lists.openstack.org">User-committee@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/user-committee" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/user-committee</a><br>
</div></div></blockquote></div><br></div></div>