On Dec 22, 11:28 am, "William Stein" <wst...@gmail.com> wrote:
<SNIP>
> > Yes, but reviews I do in that area contain detailed points which need
> > to be fixed.
>
> Making all spkg reviews have to be done by you since you're the only
> one who knows the format is bad for the busfactor of sage.
Well, I didn't do all the reviews, but before I merge an spkg I have a
look myself to assure various things didn't go wrong (you would be
amazed how many spkgs aren't based on the latest version in Sage for
example), so nearly all of the time I ended up fixing those issues
myself. After doing for a year I am tired of fixing the same problem
over and over again, so I am bouncing spkgs back until the packager
learns how to do it proper :)
> > Well, documentation in the wiki gets merged into the Developer's
> > manual and then things start to diverge. And I really dislike that.
>
> I used to think that was an intrinsic problem with wiki's but now I'm not so
> sure, given how good the Ubuntu wiki's are for sysadmin stuff, and of course
> wikipedia itself is a great example of an organized wiki.
Yes, but inconsistently creating pages without any structure is bad. I
am all for documenting things in the wiki, but it has to be structured
and we need to be able to find things. That is the reason for example
I stuck all the SPKG.txt under wiki.sagemath.org/spkg/$FOO
> > What I also very dislike is the more or less random way things are
> > structured in the wiki, i.e. while de-crapping the wiki by removing
> > Spam I have found all kind of pages I didn't know existed. Once we
> > have the ReST transition this week we will finally have persistent
> > URLs for the sections in the reference manual, so adding something in
> > the wiki that points to the reference manual is probably the best
> > solution IMHO.
>
> How about put info in the wiki, then when it is superceeded by the
> developers manual, post a link to that.
Sure, I am not doing it, but be my guest :). If anybody wants to do it
stick it into http://wiki.sagemath.org/SPKG_Audit - since there are
also various other formal things one shoudl follow.
> William
Cheers,
Michael
--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---
