[Grok-dev] Pending removal of KSS-howtos, will they be missed?
Sebastian Ware
sebastian at urbantalk.se
Wed Feb 17 06:12:00 EST 2010
I think we will get a jQuery or Mootools Ajax tutorial within a month
or two. Then we could merge the documents as a next step.
Mvh Sebastian
17 feb 2010 kl. 11.51 skrev Souheil CHELFOUH:
> If you ask me (which is not the case), I'd answer :
> 1. We can rename the document
> 2. We can propose a JQuery + megrok.resource alternative in the same
> document
>
> We could rename the documents containing "KSS" into "Ajax" and propose
> chapters with different approaches
>
> 2010/2/17 Sebastian Ware <sebastian at urbantalk.se>:
>> I think your suggested deprecation policy is reasonable. But, what
>> put
>> me off with zope.org was that all the deprecated documentation comes
>> up in search results. I hated zope.org for that, we would risk having
>> the same situation. Granted, your policy at least promises that the
>> documents work, but will they risk "spamming" search results?
>>
>> Mvh Sebastian
>>
>> 17 feb 2010 kl. 10.57 skrev Uli Fouquet:
>>
>>> Instead of simply kicking working howtos for deprecated
>>> techniques/technologies I'd opt for the following policy:
>>>
>>> for doc in all_docs:
>>> (works, deprecated) = review(doc)
>>>
>>> if deprecated and works: # deprecated != not_widely_used
>>> add_fat_big_warning(
>>> 'This one is deprecated use <link-to-replacement> instead')
>>>
>>> elif deprecated and not works:
>>> maybe_archive_somewhere(doc)
>>> del(doc)
>>> continue
>>>
>>> elif not works:
>>> maybe_fix(related_source_code)
>>> fix(doc)
>>>
>>> mark_uptodate(doc)
>>
>>
>>
>> _______________________________________________
>> Grok-dev mailing list
>> Grok-dev at zope.org
>> https://mail.zope.org/mailman/listinfo/grok-dev
>>
More information about the Grok-dev
mailing list