README.md

# Ieee1164

Diffo.IEEE1164 is about knowledge about IEEE1164.

IEEE1164 is a building block in our digital universe. Without it we wouldn't know the chemistry of advanced communications, devices, cloud, AI and the like.

## Diffo

Diffo is about knowledge about knowledge. We are knowing about Autonomous Systems and Ethical Agency.

<img src="images/diffo.jpg" width="200" alt="diffo_logo">

## Journey to the land of IEEE1164

Knowledge is relational. So we'll yarn with the ancestor of IEEE1164 and see where the journey takes us.

The journey starts in 1993, but the wisdom is much older.

### Livebook

An Elixir Livebook is the easiest way to begin. Download the [Livebook application](https://livebook.dev), then open either notebook:

**Start here — yarn with IEEE 1164:**

[![Run in Livebook](https://livebook.dev/badge/v1/blue.svg)](https://livebook.dev/run?url=https%3A%2F%2Fgithub.com%2Fdiffo-dev%2Fieee1164%2Fblob%2Fmain%2Flivebook%2Fieee1164_yarn.livemd)

**Then — know what you have learned:**

[![Run in Livebook](https://livebook.dev/badge/v1/blue.svg)](https://livebook.dev/run?url=https%3A%2F%2Fgithub.com%2Fdiffo-dev%2Fieee1164%2Fblob%2Fmain%2Flivebook%2Fknowing_std_logic_1164.livemd)

### Celebrate Your Journey

Choose a glyph memorialising when you started knowing std_logic_1164, or just pick your favourite geek aesthetic.

<details>
  <summary>Dark Mode</summary>
  <img src="images/glyphs/std_logic_1164_black.svg" alt="std_logic_1164 known in dark mode">
</details>

<details>
  <summary>Green Phosphor</summary>
  <img src="images/glyphs/std_logic_1164_green_phosphor.svg" alt="std_logic_1164 known at terminal">
</details>

<details>
  <summary>Hercules</summary>
  <img src="images/glyphs/std_logic_1164_hercules.svg" alt="std_logic_1164 known at home lab">
</details>

<details>
  <summary>X11</summary>
  <img src="images/glyphs/std_logic_1164_x11.svg" alt="std_logic_1164 known at workstation">
</details>

### Next Steps on the Journey

Maybe you've wondered why we haven't put the std_logic resolved values on the glyph? And why the glyph explains its ancestry but little else?

Maybe you understand the glyph after listening to IEEE 1164's story and can now do it yourself. That is real knowledge about knowledge. The glyph honours IEEE 1164 and is true to what we are and do at diffo.

Find out more at [diffo-dev](https://github.com/diffo-dev).

### Using ieee1164 as a dependency

If you want to build on the ieee1164 knowledge graph in your own Elixir project, add it to your `mix.exs`:

```elixir
def deps do
  [
    {:ieee1164, "~> 0.1.0"}
  ]
end
```


## Notice

License notices for code and images separately see [NOTICE](NOTICE.md)

See [CHANGELOG](CHANGELOG.md) for release history.

## Acknowledgements

Diffo IEEE1164 is new, but the ideas are not. At diffo-dev we are on a journey inspired by Indigenous Systems Thinking and offer our respect and gratitude for the profound wisdom presented by Tyson Yunkaporta in Sand Talk, grounded in countless years of sustainable, harmonious living.

Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
be found at <https://hexdocs.pm/ieee1164>.