You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-user@portals.apache.org by edingogh <by...@yahoo.com> on 2010/07/16 22:00:59 UTC
Build From Source Documentation (Apache) Hideously out of date
Right off the bat, the "Build from source" guide on the Jetspeed site is
horribly out of date. Critical information is missing, some of the
instructions steps are out of sequence, some steps are mentioned not in
their sequence but as an afterthought later in the document. Looks like
Hunter S. Thompson wrote the Apache documentation for Jetspeed--complete
stream-of-conciousness, disorganized approach.
I need to build Jetspeed (not Jetexpress or a portlet app) but the actual
Portal engine, from source. Can anyone point me to a better guide online to
building Jetspeed portal engine from source?
One of the first steps is just "checkout the source from SVN repos"---but
there are dozens of projects, none named just "Jetspeed", so no way to know
which project/projects to check out. Not in documentation.
--
View this message in context: http://old.nabble.com/Build-From-Source-Documentation-%28Apache%29-Hideously-out-of-date-tp29185756p29185756.html
Sent from the Jetspeed - User mailing list archive at Nabble.com.
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-user-help@portals.apache.org
Re: Build From Source Documentation (Apache) Hideously out of date
Posted by Ron Wheeler <rw...@artifact-software.com>.
If your application is so important to be considered career-ending,
you should give David a consulting contract to get him to help get you
started.
We were in the same situation with a project that had company-ending
potential with unreasonable timelines.
We contracted with David to get us started and we were able to meet the
timelines.
It was not very expensive and well worth the dollars, specially at the
beginning.
You can find products that are very easy to start with such as Liferay.
Some friends used that for a portal to support the administrative
functions of an on-line gambling site.
Went up fast but as soon as they started to need sophisticated
functionality, the portal development became very difficult and they
fought the system for the rest of its lifespan.
Short term happiness can sometimes be had, if you don't mind long term pain.
Jetspeed documentation is very difficult to use. It is designed to
document the range of functionality that is available.
It is not atypical for open source projects where the technical writers
are way too involved in the process and spend way too much time with
people of above-average intelligence who have the same backgrounds. They
assume that the rest of use must be that smart and have time to get
familiar with the inner workings of the tool.
In reality, we usually have our talents in other areas and only want to
know enough about the portal platform to get an application going.
But you can buy the expertise for a few dollars and you can get just as
much as you need to get you started.
Ron
On 20/07/2010 7:10 PM, David Sean Taylor wrote:
> On Fri, Jul 16, 2010 at 2:00 PM, edingogh<by...@yahoo.com> wrote:
>> Woonsan:
>>
>> That is the documentation I was talking about. The doc which is out-of-date
>> and innaccurate and incomplete.
> Could you please provide examples to substantiate your claims of
> "inaccurate" and "out-of-date" and "incomplete"?
>
> Building the source is as easy as "svn checkout" and "mvn install".
> The deployment options become a bit more involved, since there are
> database properties required
>
>> But don't worry--I've wasted enough time with Jetspeed. I've come accross
>> many other devs who have discovered the same thing about Jetspeed 2's
>> documentation "issue" as they call it.
>>
> IMO, the documentation is pretty thorough for an open source project,
> and btw I like Hunter S's books.. maybe thats the problem :-)
>
>> I have no more time to waste on it. I dread doing this, but I am going to
>> have to implement my own portal container from scratch to hit the deadline.
>> I can sense trying to use Jetspeed's documentation would be a career-ender.
> Have you tried Pluto? Perhaps you can build your new portal based on
> the Pluto portlet container, instead of writing an entire container
> from scratch. There are also other open source portals: Gatein,
> Liferay that you might want to check out. Just trying to help and be
> friendly out here in open source
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
> For additional commands, e-mail: jetspeed-user-help@portals.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-user-help@portals.apache.org
Re: Build From Source Documentation (Apache) Hideously out of date
Posted by David Sean Taylor <d....@onehippo.com>.
On Fri, Jul 16, 2010 at 2:00 PM, edingogh <by...@yahoo.com> wrote:
>
> Woonsan:
>
> That is the documentation I was talking about. The doc which is out-of-date
> and innaccurate and incomplete.
Could you please provide examples to substantiate your claims of
"inaccurate" and "out-of-date" and "incomplete"?
Building the source is as easy as "svn checkout" and "mvn install".
The deployment options become a bit more involved, since there are
database properties required
>
> But don't worry--I've wasted enough time with Jetspeed. I've come accross
> many other devs who have discovered the same thing about Jetspeed 2's
> documentation "issue" as they call it.
>
IMO, the documentation is pretty thorough for an open source project,
and btw I like Hunter S's books.. maybe thats the problem :-)
> I have no more time to waste on it. I dread doing this, but I am going to
> have to implement my own portal container from scratch to hit the deadline.
> I can sense trying to use Jetspeed's documentation would be a career-ender.
>
Have you tried Pluto? Perhaps you can build your new portal based on
the Pluto portlet container, instead of writing an entire container
from scratch. There are also other open source portals: Gatein,
Liferay that you might want to check out. Just trying to help and be
friendly out here in open source
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-user-help@portals.apache.org
Re: Build From Source Documentation (Apache) Hideously out of date
Posted by edingogh <by...@yahoo.com>.
Woonsan:
That is the documentation I was talking about. The doc which is out-of-date
and innaccurate and incomplete.
But don't worry--I've wasted enough time with Jetspeed. I've come accross
many other devs who have discovered the same thing about Jetspeed 2's
documentation "issue" as they call it.
I have no more time to waste on it. I dread doing this, but I am going to
have to implement my own portal container from scratch to hit the deadline.
I can sense trying to use Jetspeed's documentation would be a career-ender.
Woonsan Ko wrote:
>
> Hi,
>
> Would you try to follow this guide?
> http://portals.apache.org/jetspeed-2/buildguide/maven-2-build.html
>
> Regards,
>
> Woonsan
>
>
> ----- Original Message ----
>> From: edingogh <by...@yahoo.com>
>> To: jetspeed-user@portals.apache.org
>> Sent: Fri, July 16, 2010 1:00:59 PM
>> Subject: Build From Source Documentation (Apache) Hideously out of date
>>
>>
>> Right off the bat, the "Build from source" guide on the Jetspeed site is
>> horribly out of date. Critical information is missing, some of the
>> instructions steps are out of sequence, some steps are mentioned not in
>> their sequence but as an afterthought later in the document. Looks like
>> Hunter S. Thompson wrote the Apache documentation for Jetspeed--complete
>> stream-of-conciousness, disorganized approach.
>>
>> I need to build Jetspeed (not Jetexpress or a portlet app) but the
>> actual
>> Portal engine, from source. Can anyone point me to a better guide online
>> to
>> building Jetspeed portal engine from source?
>>
>> One of the first steps is just "checkout the source from SVN
>> repos"---but
>> there are dozens of projects, none named just "Jetspeed", so no way to
>> know
>> which project/projects to check out. Not in documentation.
>> --
>> View this message in context:
>>http://old.nabble.com/Build-From-Source-Documentation-%28Apache%29-Hideously-out-of-date-tp29185756p29185756.html
>>
>> Sent from the Jetspeed - User mailing list archive at Nabble.com.
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
>> For additional commands, e-mail: jetspeed-user-help@portals.apache.org
>>
>>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
> For additional commands, e-mail: jetspeed-user-help@portals.apache.org
>
>
>
--
View this message in context: http://old.nabble.com/Build-From-Source-Documentation-%28Apache%29-Hideously-out-of-date-tp29185756p29187885.html
Sent from the Jetspeed - User mailing list archive at Nabble.com.
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-user-help@portals.apache.org
Re: Build From Source Documentation (Apache) Hideously out of date
Posted by Woonsan Ko <wo...@yahoo.com>.
Hi,
Would you try to follow this guide?
http://portals.apache.org/jetspeed-2/buildguide/maven-2-build.html
Regards,
Woonsan
----- Original Message ----
> From: edingogh <by...@yahoo.com>
> To: jetspeed-user@portals.apache.org
> Sent: Fri, July 16, 2010 1:00:59 PM
> Subject: Build From Source Documentation (Apache) Hideously out of date
>
>
> Right off the bat, the "Build from source" guide on the Jetspeed site is
> horribly out of date. Critical information is missing, some of the
> instructions steps are out of sequence, some steps are mentioned not in
> their sequence but as an afterthought later in the document. Looks like
> Hunter S. Thompson wrote the Apache documentation for Jetspeed--complete
> stream-of-conciousness, disorganized approach.
>
> I need to build Jetspeed (not Jetexpress or a portlet app) but the actual
> Portal engine, from source. Can anyone point me to a better guide online to
> building Jetspeed portal engine from source?
>
> One of the first steps is just "checkout the source from SVN repos"---but
> there are dozens of projects, none named just "Jetspeed", so no way to know
> which project/projects to check out. Not in documentation.
> --
> View this message in context:
>http://old.nabble.com/Build-From-Source-Documentation-%28Apache%29-Hideously-out-of-date-tp29185756p29185756.html
>
> Sent from the Jetspeed - User mailing list archive at Nabble.com.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
> For additional commands, e-mail: jetspeed-user-help@portals.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-user-help@portals.apache.org
Re: Build From Source Documentation (Apache) Hideously out of date
Posted by edingogh <by...@yahoo.com>.
Correct: http://portals.apache.org/jetspeed-2/buildguide/maven-2-build.html
Like I noted "the Apache documentation".
That's the documentation I am talking about.
And I already have the SVN URL. That's not what my question was. You must
not have read it carefully.
Ate Douma wrote:
>
> What "Build from source" page have you been looking at?
>
> Try: http://portals.apache.org/jetspeed-2/buildguide/maven-2-build.html
>
> The svn location is mentioned right away in the first paragraph
> (prerequisites) at:
>
> http://svn.apache.org/repos/asf/portals/jetspeed-2/portal/trunk/
>
> Detailed instructions how to proceed are given further on on the page,
> but for "just" building the engine $mvn install already will do (as is
> described as well).
>
> Additional build (custom and/or maven archetype based) instructions are
> available through the Build Guide menu.
>
> Would be nice if you could review *this* (e.g. the primary) documentation
> and see if your critique still holds.
> If so, please let us know how and where we can improve it and we'll
> happily take your advise and patches when and where they make sense.
>
> With kind regards,
>
> Ate
>
> On 07/16/2010 10:00 PM, edingogh wrote:
>>
>> Right off the bat, the "Build from source" guide on the Jetspeed site is
>> horribly out of date. Critical information is missing, some of the
>> instructions steps are out of sequence, some steps are mentioned not in
>> their sequence but as an afterthought later in the document. Looks like
>> Hunter S. Thompson wrote the Apache documentation for Jetspeed--complete
>> stream-of-conciousness, disorganized approach.
>>
>> I need to build Jetspeed (not Jetexpress or a portlet app) but the actual
>> Portal engine, from source. Can anyone point me to a better guide online
>> to
>> building Jetspeed portal engine from source?
>>
>> One of the first steps is just "checkout the source from SVN repos"---but
>> there are dozens of projects, none named just "Jetspeed", so no way to
>> know
>> which project/projects to check out. Not in documentation.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
> For additional commands, e-mail: jetspeed-user-help@portals.apache.org
>
>
>
--
View this message in context: http://old.nabble.com/Build-From-Source-Documentation-%28Apache%29-Hideously-out-of-date-tp29185756p29187867.html
Sent from the Jetspeed - User mailing list archive at Nabble.com.
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-user-help@portals.apache.org
Re: Build From Source Documentation (Apache) Hideously out of date
Posted by Ate Douma <at...@douma.nu>.
What "Build from source" page have you been looking at?
Try: http://portals.apache.org/jetspeed-2/buildguide/maven-2-build.html
The svn location is mentioned right away in the first paragraph (prerequisites) at:
http://svn.apache.org/repos/asf/portals/jetspeed-2/portal/trunk/
Detailed instructions how to proceed are given further on on the page,
but for "just" building the engine $mvn install already will do (as is described as well).
Additional build (custom and/or maven archetype based) instructions are available through the Build Guide menu.
Would be nice if you could review *this* (e.g. the primary) documentation and see if your critique still holds.
If so, please let us know how and where we can improve it and we'll happily take your advise and patches when and where they make sense.
With kind regards,
Ate
On 07/16/2010 10:00 PM, edingogh wrote:
>
> Right off the bat, the "Build from source" guide on the Jetspeed site is
> horribly out of date. Critical information is missing, some of the
> instructions steps are out of sequence, some steps are mentioned not in
> their sequence but as an afterthought later in the document. Looks like
> Hunter S. Thompson wrote the Apache documentation for Jetspeed--complete
> stream-of-conciousness, disorganized approach.
>
> I need to build Jetspeed (not Jetexpress or a portlet app) but the actual
> Portal engine, from source. Can anyone point me to a better guide online to
> building Jetspeed portal engine from source?
>
> One of the first steps is just "checkout the source from SVN repos"---but
> there are dozens of projects, none named just "Jetspeed", so no way to know
> which project/projects to check out. Not in documentation.
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-user-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-user-help@portals.apache.org