Adding deprecation notices to CHICKEN 4 egg docs?
Hi all, I've noticed that the documentation for CHICKEN 3 eggs (and also for CHICKEN 2 eggs, where we have them) contain a "OUTDATED EGG" warning at the top, to warn people away from them. I'm thinking, maybe we should do something similar for CHICKEN 4 documentation now. CHICKEN 5 is now just over 2 years old[1] so it's about time, even though some eggs may not have been ported yet. Also I noticed we didn't do this for the manual itself. I think it's a good idea to that now, too. Thoughts? Comments? Cheers, Peter [1] https://lists.gnu.org/archive/html/chicken-announce/2018-11/msg1.html signature.asc Description: PGP signature
Re: Adding deprecation notices to CHICKEN 4 egg docs?
Hi, On Tue, 26 Jan 2021 14:24:29 +0100 Peter Bex wrote: > I've noticed that the documentation for CHICKEN 3 eggs (and also for > CHICKEN 2 eggs, where we have them) contain a "OUTDATED EGG" warning > at the top, to warn people away from them. > > I'm thinking, maybe we should do something similar for CHICKEN 4 > documentation now. CHICKEN 5 is now just over 2 years old[1] so it's > about time, even though some eggs may not have been ported yet. > > Also I noticed we didn't do this for the manual itself. I think it's > a good idea to that now, too. > > Thoughts? Comments? > > [1] https://lists.gnu.org/archive/html/chicken-announce/2018-11/msg1.html I think those are good ideas (adding warnings to the old manuals and to wiki pages of C4 eggs). All the best. Mario -- http://parenteses.org/mario
Re: Adding deprecation notices to CHICKEN 4 egg docs?
> Hi all, > > I've noticed that the documentation for CHICKEN 3 eggs (and also for > CHICKEN 2 eggs, where we have them) contain a "OUTDATED EGG" warning > at the top, to warn people away from them. > > I'm thinking, maybe we should do something similar for CHICKEN 4 > documentation now. CHICKEN 5 is now just over 2 years old[1] so it's > about time, even though some eggs may not have been ported yet. > > Also I noticed we didn't do this for the manual itself. I think it's > a good idea to that now, too. > > Thoughts? Comments? > Probably a good idea, perhaps with a "standard" text pointing to the most recent version (i.e. 5)? felix
Re: Adding deprecation notices to CHICKEN 4 egg docs?
On Tue, Jan 26, 2021 at 02:24:29PM +0100, Peter Bex wrote: > I'm thinking, maybe we should do something similar for CHICKEN 4 > documentation now. [...] > Also I noticed we didn't do this for the manual itself. I think it's > a good idea to that now, too. This has now been done. Cheers, Peter signature.asc Description: PGP signature
Re: Adding deprecation notices to CHICKEN 4 egg docs?
> This has now been done. Cheers, Peter Thanks! I was thinking relatedly that C5 search results should be preferred over C4 results, and somewhat along the same line, maybe title matches for searches should come up first. I'd be willing to give this a shot if someone could point me to where the wiki search is implemented. - Diego
Re: Adding deprecation notices to CHICKEN 4 egg docs?
On Tue, Feb 02, 2021 at 02:45:58PM +, Diego wrote: > > This has now been done. Cheers, Peter > > Thanks! I was thinking relatedly that C5 search results should be preferred > over C4 results, and somewhat along the same line, maybe title matches for > searches should come up first. > > I'd be willing to give this a shot if someone could point me to where the > wiki search is implemented. Hi Diego, Sure, this is at https://bugs.call-cc.org/browser/project/release/5/qwiki/trunk/qwiki-search.scm Cheers, Peter signature.asc Description: PGP signature
