Merge pull request #45 from epics-containers/dev

Removed or flagged redundant pages.

Author: gilesknap

docs/conf.py

@@ -152,7 +152,7 @@
 # to complete as the docs build warns and fails.
 html_theme_options = dict(
     logo=dict(
-        text=project,
+        text="EPICS Containers",
     ),
     navigation_with_keys=True,
     use_edit_page_button=True,

docs/index.rst

@@ -5,13 +5,9 @@
 
 Update for October 2023
 =======================
-The final round of improvements are done. The latest framework has
-become much simpler and has a good developer experience.
-
-**WARNING**
-
-The Tutorials are currently out of date and won't work. These are
-being updated now and will be available by end of November 2023.
+The tutorials are being updated to work with the improved framework.
+The first few are available now, take note of warnings about out of
+date tutorials.
 
 
 Communication

docs/user/explanations/kubernetes_cluster.rst

@@ -37,7 +37,7 @@ Three cluster topologies were considered for this project.
 Current Approach
 ----------------
 
-DLS is currently investigating Cluster per Beamline as the preferred topology. We
+DLS is using Cluster per Beamline as the preferred topology. We
 will continue to have a central cluster for shared services but in addition will
 have a cluster per beamline and a cluster for the accelerator.
 

docs/user/explanations/repos.rst

@@ -1,8 +1,9 @@
-Updating and Testing ibek-defs
-==============================
+Updating and Testing ibek-support
+=================================
 
-TODO: this is draft
-TODO: this uses a Diamond internal repo as an example
+.. Warning::
+
+    This is draft only and out of date. It will be updated soon.
 
 The ibek-defs repository contains ibek support yaml. Here is an example
 procedure for local testing of changes to support yaml in ibek-defs

docs/user/how-to/ibek-defs.rst renamed to docs/user/how-to/ibek-support.rst

@@ -11,7 +11,8 @@ The dashboard gives you a nice GUI for exploring and controlling your cluster.
 It is very useful for new users to get an understanding of what Kubernetes
 has to offer.
 
-These commands should be run INSIDE the devcontainer.
+These commands should be run after you have set up your Kubernetes cluster and
+setup the environment variables as described in `../tutorials/setup_k8s`.
 
 Execute this on your workstation:
 
@@ -48,10 +49,6 @@ Then create the admin user and role by executing the following:
 
 Get a token for the user and copy the token into your clipboard.
 
-On k3s v1.23 and older::
-
-    kubectl -n kubernetes-dashboard describe secret admin-user-token | grep '^token'
-
 On k3s v1.24 and newer::
 
     kubectl -n kubernetes-dashboard create token admin-user