From a0a261ad35e7f5b9c51fcbc04d9336e589532735 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=BAlio=20Hoffimann?= <julio.hoffimann@gmail.com>
Date: Fri, 19 Jun 2020 13:01:22 -0300
Subject: [PATCH] Fix #64: Add docs for file formats

Former-commit-id: 4eb2345374a1b53586dc855f6a65f2513eb98579
---
 docs/make.jl                                  |  5 +++-
 .../{resources.md => resources/education.md}  |  2 +-
 docs/src/resources/fileformats.md             | 25 +++++++++++++++++++
 3 files changed, 30 insertions(+), 2 deletions(-)
 rename docs/src/{resources.md => resources/education.md} (99%)
 create mode 100644 docs/src/resources/fileformats.md

diff --git a/docs/make.jl b/docs/make.jl
index 9c3e16795..94129dda2 100644
--- a/docs/make.jl
+++ b/docs/make.jl
@@ -72,7 +72,10 @@ makedocs(
       "Solver examples" => "devguide/examples.md"
     ],
     "Contributing" => "contributing.md",
-    "Resources" => "resources.md",
+    "Resources" => [
+      "resources/education.md",
+      "resources/fileformats.md"
+    ],
     "About" => [
       "Community" => "about/community.md",
       "License" => "about/license.md",
diff --git a/docs/src/resources.md b/docs/src/resources/education.md
similarity index 99%
rename from docs/src/resources.md
rename to docs/src/resources/education.md
index 09ac2f518..a63f71a95 100644
--- a/docs/src/resources.md
+++ b/docs/src/resources/education.md
@@ -1,4 +1,4 @@
-# Resources
+# Education
 
 Geostatistics is often misunderstood as "classical statistics applied to
 spatial data". To correct this unfortunate misunderstanding, the best we
diff --git a/docs/src/resources/fileformats.md b/docs/src/resources/fileformats.md
new file mode 100644
index 000000000..5c402146b
--- /dev/null
+++ b/docs/src/resources/fileformats.md
@@ -0,0 +1,25 @@
+# File formats
+
+The Julia ecosystem provides various packages for reading/writing spatial data.
+Below is an incomplete list of famous file formats:
+
+## NetCDF
+
+* [NetCDF.jl](https://github.com/JuliaGeo/NetCDF.jl) -
+  MATLAB-like syntax for reading/writing NetCDF files.
+* [NCDatasets.jl](https://github.com/Alexander-Barth/NCDatasets.jl) -
+  Read/write of NetCDF files and lazy loading.
+
+## GRIB
+
+* [GRIB.jl](https://github.com/weech/GRIB.jl) - Read/write GRIB files in Julia.
+
+## GDAL
+
+* [GDAL.jl](https://github.com/JuliaGeo/GDAL.jl) - Julia wrapper for GDAL.
+* [ArchGDAL.jl](https://github.com/yeesian/ArchGDAL.jl) - High-level API for GDAL.
+
+## GSLIB
+
+* [GslibIO.jl](https://github.com/JuliaEarth/GslibIO.jl) -
+  Read/write *extended* GSLIB files in Julia.