Hi, I've made some documentation cleanup and rdoc fixes to unify the 3 separate gems as one project and I've made a pull request but due to time constraints I didn't follow up with the maintainers Here is the branch. http://github.com/marekj/watir/tree/rdocfix It has fixes to some of the things you mention. I resend the pull request
marekj On Fri, Jun 11, 2010 at 3:13 PM, Jarmo <[email protected]> wrote: > Hello. > > I've cloned Watir's whole repo from http://github.com/bret/watir and > started to take a look on the current situation. > > I've started to notice that there's some things which should not be > maybe there anymore. I propose that these things should be deleted or > changed (that's why there's version control, isn't it?). Anyway, my > preliminary proposal is to change these things: > > > * commonwatir: > 1) History.txt - is there any plan to use it? Currently it just seems > too empty and has wrong version in it. Delete it? > 2) README.txt - has a lot of missing information there plus "FIX" > statements. Clean it up and just leave the license part maybe? > > How to run all tests for commonwatir? rake -T doesn't show any tasks > related with running all the tests from commonwatir... > > > * doc: > Is 'doc' directory a source for the website wtr.rubyforge.com a.k.a > watir.com up to date? For me, it seems not to be - so, deleting it or > making it up to date seem only reasonable options to me. > > > * firewatir: > 1) CHANGES - it seems to be out of date because latest FireWatir seems > to be also 1.6.5, but in that file it's 1.2.1... what to do? > 2) attic directory - delete? > > How to run just all firewatir tests? > > * watir: > 1) 'installer' directory seems to be obsolete... correct me if i'm > wrong. Delete? > 2) lib/readme.rb - out of date > 3) unittests/.cvsignore - delete > 4) building-watir.txt - delete? > 5) CHANGES - no changes for 1.6.5? > 6) coding_conventions.txt - is it really needed? delete? > 7) install_dev_gems.bat - shouldn't .gemspec be used for development > dependencies instead? delete? > 8) NEWCHANGES? Why is it even a separate file? And if it has changes > for Firewatir and Watir, then maybe delete CHANGES from Firewatir > altogether and/or move it's contents to Watir's CHANGES? delete? > 9) watir-rdoc.rb - why not have these in .gemspec again? delete? > 10) watir_release.txt is necessary? delete? > > Again, no rake-task for just running Watir's tests? > > commonwatir, firewatir/watir have different license types... what > about using the same license for all of these subprojects? > > If someone can give me answers to the proposals above then i could > start making the changes and perform some pull requests on github. > > Jarmo > _______________________________________________ > Wtr-development mailing list > [email protected] > http://rubyforge.org/mailman/listinfo/wtr-development > _______________________________________________ Wtr-development mailing list [email protected] http://rubyforge.org/mailman/listinfo/wtr-development
