Yes, the :top-namespace defines the standard prefix that all namespaces in your repo will have. At work we picked "ws" because we're World Singles. It just helps ensure that your code won't conflict with third party code (or at least is much less likely to conflict).

As for documentation, "top namespace" is mentioned in several places but I don't think it really explains why it is done.

Awesome, thanks. Our team has been loosely following the Polylith structure for a while now and we are finally getting around to investigating the tool. Seems like we have to conform very closely to what is described in the documentation to start seeing some benefits. We have components scattered throughout a few different directories and it looks like the tool wants us to move them all into a single place. Will be interesting to flesh it all out. Thanks again

We're migrating our legacy monorepo to Polylith. About 2/3rds done at this point. Over 100 components so far. About two dozen projects.

I've blogged about it at https://corfield.org

This looks like a great resource, will check it out!