[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: Need Feedback on HOWTO wiki created by /me.



On 2009-07-10 11:45:52 AM, Eric Christensen wrote:
> Have you looked at our Installation Guide[1]?  I would hate for you to
> have to reinvent the wheel.  Maybe you could work with the team on this
> guide?
The difference between the type of documentation that Kishan made and
our official docs is something that I've been thinking about lately.
While there definitely is a place for a comprehensive install guide
that covers every single installation case, perhaps it'd be nice to have
a shorter, less intimidating version that goes through the defaults that
most brand new users would go through.

As an example of what I mean, openSUSE has some friendly,
screenshot-filled install guides that they link off of their download
page:

http://en.opensuse.org/INSTALL_Local
http://en.opensuse.org/Installation/11.1_Live_CD

one striking fact that I noticed is that even with those tall
screenshots, both of those pages are not much larger than just the table
of contents page of our install guide
(http://docs.fedoraproject.org/install-guide/f11/en-US/html/).  

Sure, those pages don't cover the install process even nearly as
completely as our docs do, but from the perspective of a new user who
just wants to go with the defaults and get to a working system, that
style of documentation seems *really* nice.

I'm very interested to hear what you guys think about that - would
Zikula perhaps make it any easier or nicer to manage smaller documents
like these?

Thanks,
Ricky

Attachment: pgp7ELjM24OHg.pgp
Description: PGP signature


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]