On 7/18/2016 4:17 AM, clipka wrote:
> Am 17.07.2016 um 21:25 schrieb Jim Holsenback:
>> On 7/14/2016 7:15 PM, clipka wrote:
>>> I have now implemented a mechanism
>>
>> when i went to document this ... noticed syntax diagram /might/ be
>> missing the term optional in a couple of places. agreed?
>>
>> http://wiki.povray.org/content/Reference:User_Defined_Macros
>
> I guess that's a matter of philosophy: Do you want the documentation to
> generally reflect the newest version (even if that's still under
> development), with side notes mentioning what features aren't available
> in earlier versions, or do you want the documentation to generally
> reflect a well-established version, with side notes mentioning the
> features added in newer version?
>
> So far I have been following the latter approach for documenting the new
> 3.7.1 features, mostly because 3.7.1 hasn't even reached beta phase yet;
> theoretically, any modifications since 3.7.0 are still subject to
> change, and 3.7.0 is still the latest version for which we provide a
> Windows installer.
>
> But if you are significantly more comfortable with the former approach,
> I can live with that as well.
>

well yikes ... was hoping for a less vague response. i was just trying 
to be proactive. back when the new / change template request was 
suggested i roughed something out quickly but didn't get a chance to 
implement, then noticed it's usage in the documentation. couple of day 
ago had some time to put towards this and finished up the templates, 
found ALL the old usage and changed to new, even added code to 
wikidocgen to translate template to it's html equivalent. now i'm unsure 
what to do next because i was under the impression that we were running 
as fast as we can towards 3.7.1 release ... well like i said now i'm not 
sure anymore

Post a reply to this message