Lyceum-users mailing list

[Joe Harkins <joehark AT earthlink.net>]

I just came home after an evening in Manhattan so I don't have any energy 
to spare. But over this weekend, I will write up what little I know in a 
style I think will be useful. Of course, I will welcome editing and 
corrections.

Joe



At 04:27 PM 6/30/2006 -0400, Fred Stutzman wrote:

> And documentation is where the community comes into play.  If you've had
> troubles with lyceum that you've overcome, write them up and send them to
> us so we can use it in our documentation (or website).
>
> Jameson is right - there are so many systems and so many potential
> problems, that the community is the best resource.  That said, we can and
> will do better as the project matures.
>
> Joe, so by all means - any anyone else out there, you are welcome to
> contribute documentation back.  Translators, we need you too!  Perhaps it
> is time to start a lyceum-docs list, which I'm happy to take responsibility
> for.
>
> If you're interested in joining such a project (either as a doc writer for
> Lyceum or a doc translator), reply to this and lets see if we can't get
> something started.
>
> We all can make Lyceum better.  That's what's cool about open source.
>
> Thanks,
> Fred
>
>
> On Fri, 30 Jun 2006, Jameson Lopp wrote:
>
> > You have some valid points that the installation document is rather
> > 'bare bones' and could be more detailed. As it stands, the manual
> > assumes that Lyceum will be installed by a server administrator who is
> > experienced in the configuration of their own system. The instructions
> > can be somewhat vague simply because of the variety of systems on which
> > Lyceum may be installed. It would, of course, be better if we had a
> > variety of manuals for say, OS X, Linux, Windows with apache, Windows
> > with IIS, etc. Unfortunately with an entire two programmers working
> > (part time) on the project, documentation has been on the back burner.
> > John and I haven't discussed this issue yet but I can assure you that we
> > would not turn down an offer for help. The goal of this project is to
> > provide free and easy access for the public to set up blogs, thus
> > documentation is an important issue if we are to make it more available
> > to the average user.
> >
> > - Jameson
> >
> > Joe Harkins wrote:
> >> I went further and encountered an error message that did not surprise me
> >> but then, I probably have no idea what's supposed to happen.
> >>
> >> I edited the wp-config.php per my previous email and decided that the 
> other
> >> issues could be resolved later since they deal with the options of how the
> >> program treats subdomains.
> >>
> >> So I pointed my browser at: http://mydomain.com/wp-admin/install.php
> >>
> >> Which, of course, produced the error message that there is no such file. I
> >> say,
> >> "of course" because there really isn't such a file as that string defines.
> >>
> >> The path to the install.php file is:
> >>
> >> /public_html/src/lyceum/wp-admin/install.php
> >>
> >> So I tried: http://epluriblogs.com/src/lyceum/wp-admin/install.php
> >>
> >> Which, of course (again) worked - or at least has brought me to the
> >> installation setup.
> >>
> >> At this point I must pause and say, with respect but without apology, 
> these
> >> so-called installation instructions are not very well written.  They 
> suffer
> >> from a problem I have often seen in 25 years of fooling around with
> >> computers, under which instructions are written for those who really don't
> >> need them - and are a serious hurdle for those who do.
> >>
> >> This current issue - and the previous ones where assumptions are made and
> >> inaccurate advice is given ("set" for "create") - are examples of that.
> >> They are not recognized as problems because the only people who see 
> them at
> >> this stage of product development and distribution, are those who already
> >> know what is intended - and then along comes a newbie like me who takes
> >> words literally and immediately is lost.
> >>
> >> To show my sincerity, and speaking as a professional writer, I'm offering
> >> to work with someone to do a makeover of the installation instructions,
> >> "for the rest of us."
> >>
> >> Takers? Would the effort be accepted by Lyceum?  Or am I just being a pest
> >> with good intentions (as in, the paving on the road to youknowhwere.)
> >>
> >> Sincerely, Joe
> >>
> >>
> >> _______________________________________________
> >> Lyceum-users mailing list
> >> Lyceum-users AT lists.ibiblio.org
> >> http://lists.ibiblio.org/mailman/listinfo/lyceum-users
> >>
> > _______________________________________________
> > Lyceum-users mailing list
> > Lyceum-users AT lists.ibiblio.org
> > http://lists.ibiblio.org/mailman/listinfo/lyceum-users
> >
>
> --
> Fred Stutzman
> claimID.com
> 919-260-8508
> AIM: chimprawk
>
> _______________________________________________
> Lyceum-users mailing list
> Lyceum-users AT lists.ibiblio.org
> http://lists.ibiblio.org/mailman/listinfo/lyceum-users