- From: Frederick Hirsch <w3c@fjhirsch.com>
- Date: Wed, 2 Jul 2014 15:18:58 -0400
- To: cathy.chan@nokia.com
- Cc: Frederick Hirsch <w3c@fjhirsch.com>, anssi.kostiainen@intel.com, public-device-apis@w3.org, mounir@lamouri.fr
> Personally I think it flows better when that paragraph is in the BatteryManager Interface section.
I agree
You can have non-normative text in the normative section to make it clear in context.
regards, Frederick
Frederick Hirsch, Nokia
Chair DAP
@fjhirsch
On Jul 2, 2014, at 12:39 PM, <cathy.chan@nokia.com> <cathy.chan@nokia.com> wrote:
>> From: ext Kostiainen, Anssi [mailto:anssi.kostiainen@intel.com]
>>
>> On 02 Jul 2014, at 00:43, <cathy.chan@nokia.com> <cathy.chan@nokia.com>
>> wrote:
>>
>>> Yep, that takes care of the inconsistency, which was my major concern.
>>>
>>> Can we consolidate those into one paragraph, or is there some subtlety
>> that I'm missing? Each time I read through that part of the spec, I found
>> myself trying to figure out what the second paragraph is telling me that the
>> first wasn't.
>>
>> The text above the IDL reads more like an introduction, while the text below
>> contains the normative assertions.
>>
>> To clarify this, I moved the introductory-ish text that contains no normative
>> assertions to the Introduction section,
>
> Personally I think it flows better when that paragraph is in the BatteryManager Interface section.
>
>> and made the other half of the text
>> talking about the defaults a note that I placed below the normative text
>> introducing the concept:
>>
>
> This is perfect! Thanks Anssi!
>
> Regards, Cathy.
>
>
>> https://dvcs.w3.org/hg/dap/rev/3ab4af97cf9e
>>
>> Please let us know if this addresses your concern, or whether we should
>> revert back to the previous. To ease the review, here are the updated
>> sections:
>>
>> https://dvcs.w3.org/hg/dap/raw-
>> file/default/battery/Overview.html#introduction
>> https://dvcs.w3.org/hg/dap/raw-file/default/battery/Overview.html#the-
>> batterymanager-interface
>>
>>> Also, with this latest edit, I think we can also s/the implementation is
>> unable to report the remaining charging time while the battery is charging
>> but not full/the implementation is unable to report the remaining charging
>> time/ in the description of the chargingTime. That extra phrase ("while the
>> battery is charging but not full") was added to address my previous feedback,
>> but I think we don't need it anymore. Mounir, WDYT?
>>
>> Dropped "while the battery is charging but not full":
>>
>> https://dvcs.w3.org/hg/dap/rev/eb02dc5983af
>>
>> Mounir - feel free to revert or make further clarification as needed.
>>
>> Thanks,
>>
>> -Anssi
>
Received on Wednesday, 2 July 2014 19:19:35 UTC