Hi all,

So, hopefully, we can get Factor 1.0 done this year. This was my goal
in an unofficial (but no one objected to it yet) roadmap, to have
Factor done by December 31. If this still seems reasonable, we need to
make sure that the standard library is as good as we want it to be.
Regardless of the possible inclusion of new vocab roots, it seems to
me that just about every vocabulary should have (1) Documentation (2)
Unit tests (3) Metadata. Maybe (4) Clean code should be added to that
list, but it's less essential. Assembling this isn't a fun task, but I
think we need an audit of extra/.

Proposal: Give every vocabulary in extra the tag "unaudited". The
person who wrote that vocab will have the responsibility of adding
appropriate documentation, unit tests and metadata within 2 months. If
that person doesn't provide those things, then we'll divide up the
remaining vocabs among people who volunteer to audit the remaining
ones within a month or so. Good Samaritans can start auditing others'
libraries earlier, though. If we start now on a schedule that's
something like this, then everything can be audited by September.

I call this an "audit" because I think there are lots of vocabs that
people (or at least me) have written, failed to write appropriate
tests and docs, and then just forgotten about. I think the audit just
has to be of extra/ because core/ seems to be mostly appropriately
documented, tested and tagged at this point. I think it's appropriate
to do something like now, even though not all of the language features
are done, because the process of updating code for the language
features should go smoothly and orthogonally to this, and users
haven't been expected to update their own code for most language
features. (Incidentally, the audit might also include changing code to
use new-slots and no delegation, if those aren't already done by that
time.)

What do you think of this idea?

Dan

-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk

Reply via email to