Getting back into Docs

[Ryan Lerch]

On 04/14/2015 09:43 AM, Pete Travis wrote:
> On 04/13/2015 05:21 PM, Ryan Lerch wrote:
>> On 04/14/2015 09:13 AM, Pete Travis wrote:
>>>
>>>
>>> On Apr 13, 2015 9:59 AM, "Matthew Miller" <mattdm at fedoraproject.org 
>>> <mailto:mattdm at fedoraproject.org>> wrote:
>>> >
>>> > On Fri, Apr 10, 2015 at 12:06:47PM -0600, Pete Travis wrote:
>>> > > >After a few years, i am keen to start helping make Fedora docs!
>>> > > >any thoughts on where to jump in again?
>>> > > >--ryanlerch
>>> > > Hey Ryan, welcome!  I heard you moved; some nice, organized,
>>> >
>>> > Pete, is there anything Ryan can do to help with design issues around
>>> > your <https://github.com/immanetize/anerist> project?
>>> >
>>> > --
>>> > Matthew Miller
>>> > <mattdm at fedoraproject.org <mailto:mattdm at fedoraproject.org>>
>>> > Fedora Project Leader
>>> > --
>>>
>>> I gave him a brief overview of the intent behind anerist yesterday 
>>> on IRC, actually, and we discussed some of the problems I'd like it 
>>> to solve.  Hopefully you are intrigued, Ryan, the concept would 
>>> really benefit from some design love :)
>>>
>>> --Pete
>>>
>>>
>>>
>> Yeah, we chatted about this yesterday, but i didnt see the repo itself.
>>
>> Is there any docs / discussion / ideas on about how this will look at 
>> on the front end to the user?
>>
>> Not just the UI itself, but what docs we want to publish here (full 
>> books, articles, how-tos etc)? Having an idea of the best docs for 
>> our users would definitely impact the design of how we show them to 
>> the user.
>>
>> --ryanlerch
>>
>>
> We definitely want to publish the full books we already have.  We also 
> want to have targeted tutorials and smaller feature-based articles.  
> I'm expecting that these latter two will be popular contributions and 
> feel we should plan for a large volume of them.
>
> I was envisioning that these larger works would be featured higher up 
> in the category structure (and I'm reviving that thread after sending 
> this message) to keep them from getting mixed in with more atomic 
> content.  A site organized by topic seems most easily browsed, ie 
> "Networking->Routing" vs "Tutorials-> Routing" and "Articles-> 
> Routers".  Don't let that unduly influence your design vision, it's 
> only an initial idea.
>
> -- 
> -- Pete Travis
>   - Fedora Docs Project Leader
>   - 'randomuser' on freenode
>   -immanetize at fedoraproject.org
>
>
I have been thinking about this a bit overnight, and thought a good 
place to start with starting to think about a front-end design would be 
to review what docs we currently have, and then extend that to encompass 
some of the docs (articles / tutorials etc) that we might need to fill 
in the gaps.

Started a wikipage here with a small list of what (appears to me from 
looking at docs.fp.o) as the current docs:

https://fedoraproject.org/wiki/DocsProject/DocsResourcesReview

this is an open doc, so feel free to edit away

--ryanlerch
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20150414/237455e6/attachment.html>