Spaghetti documentation



  • WebSphere documentation leaves a lot to be desired.


    Reading a page called "Using WSRP services with WebSphere Portal". Lots of links, e.g. "For details about how you customize the WSRP configuration of your portal, see "Customizing the WSRP configuration of your portal" (that last being a link).


    You click on that link, and it sends you to "Using WSRP services with WebSphere Portal".


    Bah.



  •  That's not spaghetti, that's recursion. Infinite recursion at that.



  • I had a problem with Crystal Reports the other day. SAP (I think?) who owns them now broke every link in their support database. That isn't so bad on its own, but when you Google the bug I encountered, there are Microsoft support pages linking to the SAP support page that tells how to fix the bug-- the link of which is broken.

    If you break the links in your database, it's not a database anymore... it's like a data-rapidly-moving-target.



  • @blakeyrat said:

    I had a problem with Crystal Reports the other day. SAP (I think?) who owns them now broke every link in their support database. That isn't so bad on its own, but when you Google the bug I encountered, there are Microsoft support pages linking to the SAP support page that tells how to fix the bug-- the link of which is broken.

    If you break the links in your database, it's not a database anymore... it's like a data-rapidly-moving-target.

     

    Maybe the person doing the update got confused and instead of changing the content changed the location.

    I did a similar thing while writing a linked list bubble sort in early 90's.

     



  • @RTapeLoadingError said:

    Maybe the person doing the update got confused and instead of changing the content changed the location.

    I did a similar thing while writing a linked list bubble sort in early 90's.

    That was YOU!?!?

     



  • Decided to give up on WebSphere as well. We're going to come clean to this customer and explain that no, we're not intending to provide WSRP, as all available implementations that we have tried so far are substandard in some way. And all are substandard in a different way from all the others. Certainly, we could spend another few weeks evaluating several other providers, but from what we've been able to find on the internet there's not been a great many success stories, despite whatever claims that enthusiastic exponents of the technique have stated.


    If it hadn't been for their having totally destroyed their V1 support, we'd have said Liferay was actually the best of the bunch. If commercial inducement proves sufficient, we still may make an attempt at fixing it for ourselves and then offering it back to the Liferay community.


Log in to reply