[ENG-11345] improve docs and dev setup

docker-compose.yml

@@ -67,10 +67,10 @@ services:
           bin/elasticsearch-certutil cert --silent --pem -out config/certs/certs.zip --in config/certs/instances.yml --ca-cert config/certs/ca/ca.crt --ca-key config/certs/ca/ca.key;
           unzip config/certs/certs.zip -d config/certs;
         fi
-        echo "Setting file permissions"
+        echo "Setting cert file permissions (give read permission to all users -- may not be suitable for production)"
         chown -R root:root config/certs;
-        find . -type d -exec chmod 750 \{\} \;;
-        find . -type f -exec chmod 640 \{\} \;;
+        find . -type d -exec chmod 755 \{\} \;;
+        find . -type f -exec chmod 644 \{\} \;;
         echo "Waiting for Elasticsearch availability";
         until curl -s --cacert config/certs/ca/ca.crt https://elastic8:9200 | grep -q "missing authentication credentials"; do sleep 1; done;
         echo "Setting kibana_system password";
@@ -165,8 +165,7 @@ services:
       context: .
       dockerfile: Dockerfile
       target: dev
-    command:
-      /bin/bash -c 'cp -r /elastic8_certs /elastic_certs && chown -R daemon:daemon /elastic_certs/ && /usr/local/bin/celery --app project worker --uid daemon -l INFO'
+    command: /usr/local/bin/celery --app project worker --uid daemon -l INFO
     depends_on:
       - postgres
       - rabbitmq
@@ -181,7 +180,7 @@ services:
       - .docker-compose.env
     environment:
       - ELASTICSEARCH8_SECRET=secretsecret
-      - ELASTICSEARCH8_CERT_PATH=/elastic_certs/ca/ca.crt
+      - ELASTICSEARCH8_CERT_PATH=/elastic8_certs/ca/ca.crt
     stdin_open: true
     networks:
       - share_network

how-to/run-locally.md

@@ -43,12 +43,12 @@ docker-compose up -d postgres elastic8
 since we're not installing anything more on the host machine, it'll be useful to open
 a shell running within SHARE's environment in docker:
 ```
-docker-compose run --rm --no-deps worker bash
+docker-compose run --rm --no-deps indexer bash
 ```
-this will open a bash prompt within a temporary `worker` container -- from here we can
+this will open a bash prompt within a temporary `indexer` container -- from here we can
 run commands within SHARE's environment, including django's `manage.py`
 
-from within that worker shell, use django's `migrate` command to create tables in postgres:
+from within that indexer shell, use django's `migrate` command to create tables in postgres:
 ```
 python manage.py migrate
 ```
@@ -94,14 +94,14 @@ docker-compose up -d worker
 there are several ways to open a shell with SHARE's environment (which has
 django's `manage.py` and management commands defined in `management/commands/`
 
-if `worker` is already up, can open a shell within that container:
+if `indexer` is already up, can open a shell within that container:
 ```
-docker-compose exec worker bash
+docker-compose exec indexer bash
 ```
 
-if no services are up, can open a shell within a new, temporary `worker` container:
+if no services are up, can open a shell within a new, temporary `indexer` container:
 ```
-docker-compose run --rm --no-deps worker bash
+docker-compose run --rm --no-deps indexer bash
 ```
 (remove `--no-deps` if you'd like the other services started automatically)
 

how-to/use-the-api.md

@@ -8,7 +8,7 @@
 
 `GET /trove/browse?iri=...`: inquire about a thing you have already identified
 
-(see [openapi docs](/trove/docs/openapi.html) for detail and available parameters)
+(see [openapi docs](https://share.osf.io/trove/docs) for detail and available parameters)
 
 
 ### Posting index-cards