Getting back into Docs

[Pete Travis]

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

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20150413/2341c9cb/attachment.html>