Adding some comments

src/Entities/EntityFilters/VisibilityFilter.ts

@@ -22,6 +22,10 @@ import { AccountEntity } from '@Entities/AccountEntity';
 import { Logger } from '@Tools/Logging';
 import { DomainEntity } from '@Entities/DomainEntity';
 
+// A filter to return entities the requestor can "see".
+// This checks for 'friend', 'connection' and 'asAdmin' relationships
+//     and returns entities that are friends, etc of the requestor.
+//  
 // NOTE NOTE NOTE NOTE NOTE
 // This filter can't be used as a usual criteria filter because the test
 //    requires a DB $LOOKUP operation (to lookup the account of the Place's domain)

src/route-tools/Util.ts

@@ -123,6 +123,7 @@ export async function buildLocationInfo(pAcct: AccountEntity): Promise<any> {
   return ret;
 };
 
+// A smaller, top-level domain info block
 export async function buildDomainInfo(pDomain: DomainEntity): Promise<any> {
   return {
     'id': pDomain.id,

src/routes/api/v1/places.ts

@@ -41,6 +41,7 @@ const procGetPlaces: RequestHandler = async (req: Request, resp: Response, next:
   // if (req.vAuthAccount) {
     const pager = new PaginationInfo();
     const placer = new PlaceFilterInfo();
+    // you can only see friends, connections, etc
     const visibilitier = new VisibilityFilter(req.vAuthAccount);
 
     pager.parametersFromRequest(req);