I have noticed several people getting confused and disconcerted by the presence of the "Know" web in the distribution. They automatically think it is some key component of the distribution, and are reluctant to touch it, but it serves no useful purpose - so they leave it, and eventually pluck up the courage to delete it from the web list.
I really can't see any justification for continuing to distribute the "Know" web in it's present form. It isn't effective as an exemplar, as evidenced by the number of people who raise support requests after trying to copy what is done there. There are outstanding bugs against the Know web. It is generally unloved, unused, and - IMHO - in the way. We could put a documentation fix in to tell people they can delete it, but I'd be very reluctant to add yet another step to the already overcomplex installation process.
I'm putting this in as a patch proposal and unilaterally scheduling it for
CairoRelease because I really think we should do this for Cairo, and it'll be ignored otherwise. I don't have access to/sight of the release scripts so I can't actually submit a real patch.
--
CrawfordCurrie - 21 Jul 2004
- I concur - its one of the things I delete first. I'd propose that we instead make a prominent link to the
TWikiApplications page.
--
MartinCleaver - 21 Jul 2004 - 03:16
Agreed.
--
ThomasWeigert - 21 Jul 2004
Crawford, you raise a valid point.
What TWiki is lacking is a good step by step solution approach to documentation. It is not clear from the homepage (what can you actually
do with TWiki?), and not from the documentation. This should be tackled as soon as Cairo is shipped.
In the meantime I agree that the Know web can be left out, and people looking for advanced features can be directed to twiki.org.
--
ArthurClemens - 21 Jul 2004
Agreed. The Know web does not show the potential of the current TWiki. Best to remove in Cairo. Some TWiki docs make references to the Know web which needs to be fixed.
--
PeterThoeny - 22 Jul 2004
I think I fixed them all.
--
CrawfordCurrie - 22 Jul 2004