On 04/13/2015 07:13 PM, Ryan Lerch
wrote:
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@xxxxxxxxxxxxxxxxx>
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@xxxxxxxxxxxxxxxxx>
> 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@xxxxxxxxxxxxxxxxx
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
Okay, I'll fill in some fictitious/prospective article titles to
represent the kind of contributions I'd like to enable with
anerist. Hopefully that's what you're looking for.
--
-- Pete
|