expand documentation

### Describe the problem

project documentation is wip.


### Describe the proposed solution

Add:
- developing section
- project description
- add social preview

Improve:

- repository readme

### Alternatives considered

nope

### Importance

would make my life easier