Changes on IOGx section made by @zeme-wana

Author: yvan-sraka

blog/2023-11-13-devx.md

@@ -152,47 +152,31 @@ To make the DevX developer shell available in a VSCode DevContainer or GitHub Co
 ```
 You can follow the [Microsoft tutorial](https://code.visualstudio.com/docs/devcontainers/tutorial) to set-up your VSCode local DevContainer or you can give it a try by [opening a GitHub Codespace](https://codespaces.new/input-output-hk/cardano-base?quickstart=1) on [`cardano-base`](https://github.com/input-output-hk/cardano-base) repository!
 
-## IOGx: A Flake Template for Haskell Projects at IOG
+## IOGx: Flake Templates for Projects at IOG
 
-IOGx is a flake template that offers a development experience for Haskell projects at IOG. Its vision is to provide a JSON-like, declarative interface to Nix, enabling developers unfamiliar with the Nix language to maintain and enhance the Nix sources independently with minimal effort. This is motivate by the current fact that the learning curve for Nix is steep and the documentation is not yet as beginner friendly than it could be.
+IOGx is a Nix library of functions and templates for structuring your Nix code and comes with a number of common DevX facilities to help develop your project. Its vision is to provide a JSON-like, declarative interface to Nix, enabling developers unfamiliar with the Nix language to maintain and enhance the Nix sources independently with minimal effort. This is motivated by the current fact that the learning curve for Nix is steep and the documentation is not yet as beginner friendly than it could be.
 
 ### Getting Started with IOGx
 
-Kick-start your project with IOGX by running the following command:
+Kick-start your project with IOGx by running the following command:
 ```
-yvan@X230 ~/iogx-demo % nix flake init --template github:input-output-hk/iogx
-
+yvan@X230 ~/iogx-demo % nix flake init --template github:input-output-hk/iogx#vanilla
 wrote: /Users/yvan/iogx-demo/nix/outputs.nix
 wrote: /Users/yvan/iogx-demo/nix/shell.nix
 wrote: /Users/yvan/iogx-demo/nix
 wrote: /Users/yvan/iogx-demo/flake.nix
-
 Flake Template for Vanilla Projects
-
     Open flake.nix to get started.
-
 ```
 This command generates a `flake.nix` and a `nix` folder containing various file templates.
-These files form the *filesystem-based* API of IOGX.
 
-The next steps involve populating the templates in the `nix` folder, leaving `flake.nix` mostly untouched.
-Based on the contents of the `nix` folder, IOGX populates your flake outputs.
+The next steps involve populating the templates in the `nix` folder and `flake.nix` itself.
 
 ### IOGx Features
 
-IOGx comes packed with numerous features that enhance the Haskell development process:
-
-- **GHC Build Matrices**: IOGx enables defining a set of GHC versions, for each of which it generates `devShells`, `packages`, `apps`, `checks`, and `hydraJobs`. These outputs also include profiled builds and Windows cross-compiled builds.
-
-- **Extensible Development Shells**: Every `devShell` comes with a complete Haskell toolchain that can be easily extended with new packages, custom scripts, environment variables, and hooks.
-
-- **Automatic Hydra Jobset**: By default, your `hydraJobs` will include every Haskell component in your project. Test suites will run in CI automatically.
-
-- **Easy Code Formatting**: IOGx employs [`pre-commit-hooks`](https://github.com/cachix/pre-commit-hooks.nix) for source tree formatting. These hooks are easily configurable and run automatically in CI unless explicitly disabled.
-
-- **Read The Docs Support**: If your project requires a [Read The Docs](https://readthedocs.org) site, IOGX will include the necessary tools and scripts and add the relevant derivations to CI.
+IOGx comes packed with numerous [features](https://github.com/input-output-hk/iogx#2-features) that enhance the Haskell development process.
 
-To delve deeper into IOGx and its API, refer to the comprehensive [API Reference](https://github.com/input-output-hk/iogx#3-api-reference). IOGX aims to facilitate a pleasant and efficient development process for Haskell projects at IOG, minimizing the need for extensive Nix language knowledge.
+To delve deeper into IOGx and its API, refer to the comprehensive [API Reference](https://github.com/input-output-hk/iogx/blob/main/doc/api.md). IOGX aims to facilitate a pleasant and efficient development process for Haskell projects at IOG, minimizing the need for extensive Nix language knowledge.
 
 ## Hix