update docs and examples

README.md

@@ -6,21 +6,17 @@
 | [![][docs-development-img]][docs-development-url] |                                 |
 
 Karnak.jl is a small extension for the Luxor.jl package to
-help with constructing graph-style drawings.
+help with visualizing graphs and networks.
 
-Karnak relies on [Graphs.jl](https://github.com/JuliaGraphs/Graphs.jl) for graph construction, and
-on [NetworkLayout.jl](https://juliagraphs.org/NetworkLayout.jl/) for graph layout.
+Karnak also relies on
+[Graphs.jl](https://github.com/JuliaGraphs/Graphs.jl) for
+graph construction, and on
+[NetworkLayout.jl](https://juliagraphs.org/NetworkLayout.jl/)
+for graph layout.
 
-The focus in Karnak, unlike other graph visualization
-packages, is on decorative and aesthetic uses, for use in
-design, generative art, social media previews, NFTs, and
-other mission-critical items, rather than on
-scientific rigor and mathematical elegance. So...
+## See also
 
-## Warning
-
-For scientific and technical visualization, use one of
-the following Julia packages to visualize your graphs:
+There's a good selection of Julia packages for visualizing graphs:
 
 - [TikzGraphs.jl](https://github.com/sisl/TikzGraphs.jl): backend: Tikz/Latex
 

docs/src/assets/styles.css

@@ -1,12 +1,12 @@
 @font-face {
-	font-family: JuliaMono-Light;
-	src:
-		local('JuliaMono-Light'),
-		url("https://github.com/cormullion/juliamono/raw/master/webfonts/JuliaMono-Light.woff2");
+    font-family: JuliaMono-Light;
+    src:
+        local('JuliaMono-Light'),
+        url("https://github.com/cormullion/juliamono/raw/master/webfonts/JuliaMono-Light.woff2");
 }
 
 pre, code {
-	font-family: JuliaMono !important;
+    font-family: JuliaMono !important;
     font-feature-settings: "calt" 1;
 }
 
@@ -28,14 +28,14 @@ p > a:after {
 }
 
 html.theme--documenter-dark p > code {
-	  	color: #eff !important;
+          color: #eff !important;
 }
 
 html.theme--documenter-dark li > code {
-	  	color: #eff !important;
+          color: #eff !important;
 }
 
 
 html.theme--documenter-dark a > code {
-	  	color: #eff !important;
+          color: #eff !important;
 }

docs/src/basics.md

@@ -15,8 +15,9 @@ of programming in Julia.
     pages are built by Documenter.jl, and the code to draw
     them is included here. SVG is used because it's good for
     line drawings, but you can use `drawgraph()` in any
-    Luxor environment, such as PNG  - recommended as the
-    drawings get very complex, since large SVGs can tax browsers.
+    Luxor environment, such as PNG  - which is the
+    recommended format to use as the drawings get very
+    complex, since large SVGs can tax web browsers.
 
 ## Graphs, vertices, and edges