What does this mean?
The old Cascades and Core documentation focus controller in the header is gone! Everything is in one place on the Documentation tab. That doesn't mean that anything has disappeared though.
You can still navigate in the API Reference by using the Cascades and Core radio buttons.
And you can still filter your favorite Sample apps to see only Cascades or Core sample apps.
Unfortunately, the complexity of this change to our site means that some Disqus comments are no longer available. If you've left a comment, you might find that trying to access the page with that comment generates a "Page not found" error. For more information, see our Disqus FAQ.
Where did the documentation go?
It's all still there, but language-specific details appear in tabs. You can find information about how to add functionality to your app, plus code samples in QML, C++, and C.
We merged the Core and Cascades content in many places. For example, everything you want to know about using the camera in your app is all in one place.
All of the information that you need appears here in this documentation or the topics that it links to. We describe general concepts and tasks that you might want to do in your app. Then we get into details with code samples.
The Cascades code samples are in the QML and C++ tabs, and code samples that previously appeared in the Core documentation now appear in the C tab. One of these tabs is selected when you land on a page, and this tab is called the active tab. You don't have to go to two separate places to find out how to add camera features to your app. The code samples provide equivalent or nearly equivalent ways of doing tasks in each language.
Here's an example:
How do I find anything?
The following categories will help you find the documentation that you need:
This section hasn't changed very much. But you may want to check out the tutorial to create your first Cascades app. It's been updated to work on all BlackBerry 10 devices, and it's a good place to start if you want to learn about design units and asset selectors.
This is where you'll find all of the basics that you need to know, including Cascades fundamentals and Using low-level functionality (if you love to code in C). Don't forget to check out Device characteristics to make sure that you're designing your app for all BlackBerry 10 devices.
Here's where you'll find out about your favorite Cascades controls. The documentation is the same but better because there are more code samples in both QML and C++ throughout.
These best practices will help you design apps that optimize performance and accessibility. Don't forget to follow the best practices for handling Personally identifiable information in your apps.
This set of documentation has expanded to include more details about adding graphics, audio, video, and camera features to your app.
We've merged the documentation from Cascades and Core to give you the highlights for communicating with devices. The biggest change is in the Input methods documentation where you'll find out how to implement every kind of input method for every BlackBerry 10 device.
Here's where you'll find platform features that you can incorporate into your app. Check out the BlackBerry Hub integration documentation to learn how to use the Unified Data Source (UDS) library to add data from your app directly to the BlackBerry Hub.
Are you sure that it's all there?
Yes! And there's even more! Where it's possible, we've added code samples in QML, C++, and C. Where it's not possible to complete the task in a particular coding language, you'll see Not applicable. If we're still working on updating the code samples, you'll see Coming soon.
The QML and C++ code samples typically use Cascades APIs. The C samples use C APIs. But don't forget that you can use C APIs in your C++ code as well. Check out the BlackBerry Platform Services documentation for useful techniques. And don't forget to try the Using BPS tutorial to learn how to use C APIs in your C++ app.
Now you can have your cake and eat it too!