aspirational documentation for new repo lists

aspirational documentation for new repo lists

the documentation came first, which was good, because it made me think about what i wanted the repository list feature to really be.
unfortunately, that's the only change so far, so now the docs and code behavior don't match.  argh!  but soon the feature will get implemented and we'll be back in the rationality zone.