[Grok-dev] Pending removal of KSS-howtos, will they be missed?

Souheil CHELFOUH trollfot at gmail.com
Wed Feb 17 05:51:27 EST 2010


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