Greetings, and thank you for such a prompt reply.
Quoting Emmanuel Blot <[EMAIL PROTECTED]>:
I'm not sure you can get positive feedback to your question with such
a subject...
OK, You caught me, I was venting. But you must admit, it's an attention
getter. ;)
Anyway: Trac documentation is available on the web site, but the
documentation also comes with the Trac package itself as wiki pages,
which are automatically installed as the default pages when you
initialize your Trac environment.
Thank you. Yea, I caught that on the web site.
This may feel a bit like the chicken and egg issue.
Basically, the administrator needs to browse the official web site
(TracInstallation is a good starting point) to set up a workable
environment - when the environment is created, the documentation is
automatically added as wiki pages, then your Trac users may browse the
Trac "user" documentation from your installation.
Thanks, I caught that on the web site as well.
If you look for a all-in-one PDF (or m$ doc) document file, you'll get
disappointed: Trac documentation is mostly available as wiki pages.
Yea, looks like I'll have to convert our local site into a PDF and send
it to the folks at FreeBSD. So they can make their port complete.
I still can't understand why it won't/ can't be distributed with
documentation. It ultimately creates an exercise in frustration
for a new administrator/ user.
Thanks again for your prompt response.
HTH,
Manu.
On 6/7/06, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote:
Greetings,
We have some 70 developers as clients on our servers. I made the
effort to install Trac on one of them. Thinking that it might be
an appealing alternative to the CVS systems we currently offer.
Imagine my surprise to discover that it is completely undocumented.
What possible use could it be without documentation?! Or better;
what possible motive could one have for distributing it without
documentation? To breed contempt in administrators, whom believe
that they are installing a complete application? Indeed, I did
discover the blurbs (README) indicating that the documentation
was available on the web site. This is not an ideal situation for
an end user/ administrator. I installed this from the ports tree
on one of our FreeBSD servers. I decided to download the same
version number (.95) from the web site, thinking that the
documentation would accompany it. But (as you already know)
this is not the case. I then looked for a downloadable copy
of documentation on the web site. But of course, none was
available. This seems quite preposterous, given that documentation
clearly exists. Would you be kind enough to inform me when
documentation will be available for users locally with their
installed distribution?
Thank you for all your time and consideration.
-----------------------------------------------------------------
FreeBSD 5.4-RELEASE-p12 (SMP - 900x2) Tue Mar 7 19:37:23 PST 2006
/////////////////////////////////////////////////////////////////
_______________________________________________
Trac-dev mailing list
Trac-dev@lists.edgewall.com
http://lists.edgewall.com/mailman/listinfo/trac-dev
--
Manu
_______________________________________________
Trac-dev mailing list
Trac-dev@lists.edgewall.com
http://lists.edgewall.com/mailman/listinfo/trac-dev
-----------------------------------------------------------------
FreeBSD 5.4-RELEASE-p12 (SMP - 900x2) Tue Mar 7 19:37:23 PST 2006
/////////////////////////////////////////////////////////////////
_______________________________________________
Trac-dev mailing list
Trac-dev@lists.edgewall.com
http://lists.edgewall.com/mailman/listinfo/trac-dev
