FAKE TEST CHANGE

SDL App Library Guide Content

The iOS, Java Suite (Android, JavaEE, and JavaSE), and JavaScript Suite guides are located on the SDL Developer Portal.

Overview

Since the iOS, Java Suite, and JavaScript Suite guides provide almost the same instructions and information, the content of each section should be written as generically as possible. This allows the guides to be written once for all platforms with little modification needed. If a guide is specific to one platform or has content specific to one platform, like code snippets, the content should be separated out using custom platform tags.

Guide documents are formatted using a custom SDL markdown format. All guides get created as directories inside this repository. Each directory gets a link in the left-hand sidebar on smartdevicelink.com. Guides do not currently support multiple pages or sub-directories.

Learn how to use SDL flavored markdown (aka DocDown) at the spec page.

Custom SDL Markdown Tags

Basic markdown tags will act as expected, including headings, bold, italics, and tables. In addition, there are SDL specific custom extensions for inline notes and relative links to assets.

Specifying Platforms

This repository has additional markdown customizations to permit content to be included or excluded from a platform. This can be done inline within a guide in order to, for example, display one code snippet for iOS and another for Java-family platforms. This can also be done within the configuration file in order to allow a guide, such as a guide demoing how to deploy a Java Web app to AWS, to only build for the JavaEE platform.

Valid Tags

Platform	Tag
iOS	@![iOS] ------- !@
Android	@![android] --- !@
JavaEE	@![javaEE] ---- !@
JavaSE	@![javaSE] ---- !@
JavaScript	@![javascript]- !@

How to Use Inline Tags

Inline tags allow you to create content that is only rendered for the specified platforms within a guide that is available on multiple platforms. For example, if you have a guide available on Android, JavaSE, and JavaEE but not on iOS (see below How to Use Configuration Tags for how to configure guide availability), then you can use inline tags to render some content for Android that won't be rendered for JavaSE or JavaEE, or visa versa.

# How To Code Stuff
Here is non-platform specific documentation and instructions that tell the developer things and stuff and how to do whatever

## Code Example
@![android]
This is an Android specific instruction that only applies to the Android platform.

```java
(Android code snippet)
``` !@

This is a JavaSE and JavaEE specific instruction that only applies to the Java platform.
@![javaSE,javaEE]
```java
(Java code snippet)
``` !@

How to Use Configuration Tags

Configuration tags allow to you create guides that are only available for the specified platforms. If no platforms are included for a section, the section will be generated for all possible configured platforms.

{
  "name": "Hello Sdl Android",
  "platforms":["Android"]
}

This code snippet shows how to configure a guide to only be made available for the Android platform guides.

To create a link to a header:

The first character must be a #
All characters must be lowercased
All spaces need to be replaced by a hyphen
Apostrophes need to be removed

Examples

To link to a header on the same page:

### Supporting Service RPCs and Actions

Use the following formatting:

[Supporting Service RPCs and Actions](#supporting-service-rpcs-and-actions)

To link to a header on a different page:

To link to the following header on a page called Using App Services:

### Getting and Subscribing to Services