[preview] First round of major dev guide revisions #9

tbuschto · 2019-02-19T10:01:57Z

This PR corresponds to gerrit change 17855. It is meant for preview, commenting and discussion, the actual commit votes should be given on gerrit.

Since this it too much for a single person to review in one go i would hope that everyone has a look at an another article every now and then until everything has been covered by at least one person.

This is the first round of planned changes to the developer guide, basically revising all content we already have. After this is merged I plan on splitting and adding a few articles, add/check links, snippets and screenshots, etc.

Comment here: https://github.com/eclipsesource/tabris-js-docs/pull/9/files. Click "View file" to see it rendered.

docs/3.0/JSX.md

docs/3.0/build.md

docs/3.0/cordova.md

docs/3.0/debug.md

docs/3.0/developer-app.md

docs/3.0/faq.md

docs/3.0/getting-started.md

docs/3.0/layout.md

docs/3.0/selector.md

docs/3.0/touch.md

docs/3.0/types.md

docs/3.0/w3c-api.md

docs/3.0/faq.md

docs/3.0/developer-app.md

docs/3.0/JSX.md

docs/3.0/build.md

docs/3.0/ui.md

docs/3.0/widget-basics.md

jonek

I left some comments.

docs/3.0/build.md

jonek · 2019-02-27T08:29:22Z

docs/3.0/build.md

+| Name                    | Value |
+|-------------------------|-------|
+| Theme                   |- `@style/Theme.Tabris`<br/>- `@style/Theme.Tabris.Light`<br/>- `@style/Theme.Tabris.Light.DarkAppBar` (Default)<br/><br/>In addition to the bundled Tabris themes, a resource reference to a custom Android theme can be specified. Custom themes have to inherit from one of the Tabris base themes.<br/><br/>Example: `<preference name="Theme" value="@style/Theme.MyAppTheme" />` |
+| ThemeSplash             | - `@style/Theme.Tabris.SplashScreen`<br/>- `@style/Theme.Tabris.Light.SplashScreen` (Default)<br/><br/>The splash screen is shown to the user while the app is starting up. By default this screen has a white background. The `ThemeSplash` preference allows to set one of the bundled themes or to provide a custom theme.<br/><br/>Example: `<preference name="ThemeSplash" value="@style/Theme.Tabris.SplashScreen" />`<br/><br/>Note that the `config.xml` element `<splash .. />` can be used to set an image on the splash screen. For styling guides see the material design guidelines on [launch screens](https://material.google.com/patterns/launch-screens.html). |


Same thought as @cpetrov we should link to visual examples i.e. screenshots.

docs/3.0/build.md

jonek · 2019-02-27T09:43:12Z

docs/3.0/build.md

+
+On the first start, the Tabris CLI will ask for a build key.
+You can find this key on your [profile page](https://tabrisjs.com/settings/account).
+


Maybe add a screenshot here that shows where to find the "build key".

O yeah, i have been asked that many times. But maybe a more prominent placement would be even better than a screenshot?

Remove references to iOS 9 (no longer supported)

tbuschto · 2019-02-28T17:06:24Z

docs/3.0/faq.md

+
+### What Cordova versions is Tabris.js based on?
+
+|         | Tabris.js 3.x |


@mpost What about Tabris.js 2?

[preview] First round of major dev guide revisions

85302f9

tbuschto requested review from mpost, jonek, ifurnadjiev, karolszafranski, cpetrov, ahmadov, patrykmol, elshadsm and dbuschtoens February 19, 2019 10:01