cordova-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <>
Subject [jira] [Commented] (CB-10330) Define a standard way to document references in the new IA
Date Thu, 21 Jan 2016 17:48:39 GMT


ASF GitHub Bot commented on CB-10330:

Github user nikhilkh commented on the pull request:
    This looks great! Couple of comments - while your example illustrates this - your specification
is not very precise:
    1. Consider clarifying the position of 'Required', 'Default' in the description. Also,
consider structure the details e.g. Description should include the following in order:
    - Default: Use *italics* formatting to provide default value of the attribute
    - Required: Use *italics* formatting to provide whether the attribute is required. I would
imagine if a value is not required - there would be a default value.
    - Platforms supported: Use **bold** to specify platforms supported. Default is supported
in all platforms.
    2. Consider making the platform supported part of the description instead of the name.
You can still use bold.

> Define a standard way to document references in the new IA
> ----------------------------------------------------------
>                 Key: CB-10330
>                 URL:
>             Project: Apache Cordova
>          Issue Type: Task
>          Components: Docs
>            Reporter: Raghav
>            Assignee: Raghav
>              Labels: Docs-6.x
> We have a new section for references in the new IA which will have the following articles:
> Config.xml
> Events
> Plugin APIs
> Hooks
> Plugin.xml
> We need to define a uniform standard for these to follow. Some of these are API references,
some XML. 

This message was sent by Atlassian JIRA

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message