Newest SQL Anywhere 17 documentation on DCX or SAP Help Portal?

[VolkerBarth]

Where is the current "official" SQL Anywhere 17 documentation hosted?

• On DCX
• On SAP Help Portal

I would prefer the first one because of all the older documentations and the comment facility. But it seems that the later is more up-to-date, because w.r.t. support packages,

• DCX: Upgrading to the latest patch of SQL Anywhere 17.0 - relating to build 17.0.4.2000 (with some comments on newer changes)

vs.

• Help Portal: Upgrading to SQL Anywhere 17.0 Support Package PL 22 Build 4003,

the second is apparently newer.

Is there a general decision to focus on SAP Help Portal?

(FWIW, the later is also more appropriate on mobile devices where DCX just s.cks...)

[Vlad]

I like DCX because of comments.

[VolkerBarth]

FWIW, a related discussion has been made raised [here] (http://sqlanywhere-forum.sap.com/questions/29745/is-dcx-being-replaced-by-sap-help-portal)

[Vlad]

Volker, finally I have decided to figure out why DCX doesn't work on mobile devices.

It seems that the issue is caused by GWT (the framework that is used for this web site). The code is very minified and "encrypted", it was hard to understand what is going wrong.

GWT (2.6.0 - quite old version. the new one is 2.8.2) subscribes to all events that might occur (in our case this is gesturestart and gesturend). When the user scrolls the iframe, some internal veriables get "undefined" and fail.

I do not know the solution instead of not using the mobile device at all, but I guess this is nothing we can do with it. It is funny, if I put the breakpoint in JavaScript and do not allow the browser to rethrow the exception, the device is able to scroll the content further.

I am afraid we have to use the new web site 😞 I will be missing DCX.

[Vlad]

o-o-o-oh 😞

The chapters are organized in a different order than in the old web site. Some of them were renamed. E.g. I like "dashes" in the chapter name. E.g.

"MobiLink Getting Started"  instead of "MobiLink - Getting Started"
"SQL Anywhere Introduction" instead of "SQL Anywhere - Introduction"

Chapters have a different grouping and sorting order. E.g. it looks funny to me, when SQL Anywhere has MobiLink on the first place in "Getting Started". Or why "SQL Anywhere Server - SQL Usage" is so far from the "SQL Anywhere Server - SQL Reference".

[VolkerBarth]

The priority on MobiLink might be due to the fact that ML in its HANA Remote Sync variant is part of the HANA cosmos...

[Vlad]

hm... I disagree. The help is related to SA. The important order for me is:
- what's new
- what SA is
- installation guide
- development (tutorials + sql reference)
- administration/performance/other stuff.

[VolkerBarth]

To clarify: My last comment did not state my own preferences but contained my guess why SAP might be using a different doc order within the Help Portal...

Personally, I like the original doc order within DCX (identical to the local help which I usually use for performance reasons...).

[Former Member · Accepted solution]

For the latest information about SQL Anywhere 17, visit the SAP Help Portal. For earlier and translated versions of the documentation, use DCX.

Did you know that you can leave feedback on the SQL Anywhere documentation on the Help Portal?

1. On any topic, click Yes or No on the Feedback pane to specify whether the topic was helpful, and then use the text box to provide suggestions and corrections to improve the documentation for all users in future releases.
2. Click Submit.

The SQL Anywhere documentation team appreciates you taking the time to share your comments.

[Vlad · Accepted solution]

Oh. I am glad somebody is reading the comments. I am trying to improve the documentation for HANA (development), and it seems my requests are ignored. Unfortunately there is no feedback on your feedback, as it existed in DCX.sap.com. I forgot who, but somebody even replied to my comments.

[Former Member · Accepted solution]

Unfortunately, we do not yet have the ability to see and reply to comments on the Help Portal, but, rest assured, we do read the feedback and incorporate it into the documentation.

[Breck_Carter · Accepted solution]

> visit the SAP Help Portal

...it makes me want to write another book 🙂

[VolkerBarth · Accepted solution]

Dove, does that mean comments are no more desired on DCX?

Frankly, my personal experience with the SAP Community has been rather disappointing after the relaunch October 2016, and it is still work in progress.. So I would surely prefer the working DCX pages...

[Former Member · Accepted solution]

Comments are still welcome on DCX. We monitor them and incorporate the feedback into the documentation. There are topics on DCX that are out of date, though, and topics on the Help Portal that don't exist on DCX.

[VolkerBarth]

FWIW, the SQL Anywhere doc set on the SAP Help Portal has another "What's New" section for the minor version 17.0.9:

Upgrading to SQL Anywhere 17.0 Support Package PL29 Build 4793

[MarkCulp]

The latest updates for 17.0.8 are available on the Help Portal. There is a link at the top of the DCX home page indicating this and that takes users to the Help Portal.

[VolkerBarth]

Mark, well, that's my basic question: Does it mean the DCX site will fall behind in course of the time?

As Vlad has pointed out, the v17 doc set seems to be different on both platforms, so it's somewhat unclear which one should be preferred...

[VolkerBarth]

Mark, a clearer statement would be appreciated...:)