FEAT: New docs restructure

README.md

@@ -0,0 +1,72 @@
+# **P**hotonic **I**ntegrated **EL**ectronics
+
+[![PyPI
+Name](https://img.shields.io/badge/pypi-piel-blue)](https://pypi.python.org/pypi/piel)
+[![PyPI
+Version](https://img.shields.io/pypi/v/piel.svg)](https://pypi.python.org/pypi/piel)
+[![Build
+Status](https://img.shields.io/travis/daquintero/piel.svg)](https://travis-ci.com/daquintero/piel)
+[![Documentation
+Status](https://readthedocs.org/projects/piel/badge/?version=latest)](https://piel.readthedocs.io/en/latest/?version=latest)
+[![MIT](https://img.shields.io/github/license/gdsfactory/gdsfactory)](https://choosealicense.com/licenses/mit/)
+[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+Microservices to codesign photonics, electronics, communications,
+quantum, and more.
+
+-   Free software: MIT license
+-   Documentation: <https://piel.readthedocs.io>
+
+## Target functionality
+
+-   Co-simulation and optimisation between integrated photonic and
+    electronic chip design.
+-   System interconnection modelling in multiple domains.
+-   Chip and interposer design integration.
+-   Component models translation library between simulation tools.
+-   Quantum models of physical circuitry.
+
+`piel` aims to provide an integrated workflow to co-design photonics and
+electronics, classically and quantum. It does not aim to replace the
+individual functionality of each design tool, but rather provide a glue
+to easily connect them all together and extract the system performance.
+
+## Examples
+
+Follow the many [examples in the
+documentation](https://piel.readthedocs.io/en/latest/examples.html).
+
+## Microservices Toolset
+
+This package provides interconnection functions to easily co-design
+microelectronics through the functionality of the
+[IIC-OSIC-TOOLS](https://github.com/iic-jku/iic-osic-tools) and
+photonics via [GDSFactory](https://github.com/gdsfactory/gdsfactory).
+
+![image](docs/_static/img/piel_microservice_structure.png)
+
+Some existing microservice dependency integrations are:
+
+-   [cocotb](https://github.com/cocotb/cocotb) - a coroutine based
+    cosimulation library for writing VHDL and Verilog testbenches in
+    Python.
+-   [hdl21](https://github.com/dan-fritchman/Hdl21) - Analog Hardware
+    Description Library in Python
+-   [GDSFactory](https://github.com/gdsfactory/gdsfactory) - An open
+    source platform for end to-end photonic chip design and validation
+-   [OpenLane v1](https://github.com/The-OpenROAD-Project/OpenLane) - an
+    automated RTL to GDSII flow based on several components including
+    OpenROAD, Yosys, Magic, Netgen and custom methodology scripts for
+    design exploration and optimization
+-   [sax](https://github.com/flaport/sax) - S-parameter based frequency
+    domain circuit simulations and optimizations using JAX.
+-   [thewalrus](https://github.com/XanaduAI/thewalrus) -A library for
+    the calculation of hafnians, Hermite polynomials and Gaussian boson
+    sampling.
+-   [qutip](https://github.com/qutip/qutip) - QuTiP: Quantum Toolbox in
+    Python
+
+## Contribution
+
+If you feel dedicated enough to become a project maintainer, or just
+want to do a single contribution, let\'s do this together!

README.rst → docs/README.rst

@@ -37,7 +37,7 @@ microelectronics through the functionality of the
 `IIC-OSIC-TOOLS <https://github.com/iic-jku/iic-osic-tools>`__ and
 photonics via `GDSFactory <https://github.com/gdsfactory/gdsfactory>`__.
 
-.. image:: docs/_static/img/piel_microservice_structure.png
+.. image:: _static/img/piel_microservice_structure.png
 
 Some existing microservice dependency integrations are:
 

docs/examples/04_spice_cosimulation.py

@@ -212,7 +212,7 @@
 
 h.netlist(our_resistive_heater_circuit, sys.stdout, fmt="spice")
 
-# ```spice
+# ```
 # * Anonymous `circuit.Package`
 # * Generated by `vlsirtools.SpiceNetlister`
 # *

docs/index.rst

@@ -1,6 +1,6 @@
 .. _readme:
 
-.. include:: ../README.rst
+.. include:: README.rst
 
 
 Contents

setup.py

@@ -4,7 +4,7 @@
 
 from setuptools import setup, find_packages
 
-with open("README.rst") as readme_file:
+with open("README.md") as readme_file:
     readme = readme_file.read()
 
 requirements = [