[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