docs: make the generic intro a quote, sections fix

also explain dir structure
This commit is contained in:
əlemi 2024-08-17 17:18:12 +02:00
parent e0f12949c7
commit 8ae20d8150
Signed by: alemi
GPG key ID: A4895B84D311642C

View file

@ -2,21 +2,21 @@
<a href="https://codemp.dev"><img alt="codemp logo" align="center" src="https://codemp.dev/codemp-t.png" height="100" /></a>
> code multiplexer for neovim
### code multiplexer for neovim
CodeMP is a **collaborative** text editing plugin to work remotely.
> CodeMP is a **collaborative** text editing plugin to work remotely.
It seamlessly integrates in your editor providing remote cursors and instant text synchronization,
as well as a remote virtual workspace for you and your team.
CodeMP is build with state-of-the-art CRDT technology, guaranteeing eventual consistency.
> CodeMP is build with state-of-the-art CRDT technology, guaranteeing eventual consistency.
This means everyone in a workspace will always be working on the exact same file _eventually_:
even under unreliable networks or constrained resources, the underlying CRDT will always reach a
convergent state across all users. Even with this baseline, CodeMP's proto is optimized for speed
and low network footprint, meaning even slow connections can provide stable real-time editing.
> This is the reference codemp neovim plugin maintained by [hexedtech](https://hexed.technology)
This is the reference codemp neovim plugin maintained by [hexedtech](https://hexed.technology)
## usage
# usage
> [!CAUTION]
> codemp-nvim is not finished nor ready for early adopters, this is a demo
@ -55,10 +55,10 @@ after a workspace is joined, more commands become available:
MP command autocompletes available options for current state, so cycle <Tab> if you forget any name
### configuration
## configuration
it's possible to configure global `vim.g.codemp_username` and a `vim.g.codemp_password` which will be used when connecting
## installation
# installation
> [!IMPORTANT]
> the release zip provided is a tech demo for linux, there are no official releases yet
@ -67,7 +67,16 @@ it's possible to configure global `vim.g.codemp_username` and a `vim.g.codemp_pa
* place the whole `codemp` folder under your `.config/nvim/lua` directory
* add `CODEMP = require('codemp')` at the end of your `init.lua`
### building
## building
this plugin relies on the native codemp lua bindings: just compile the main `codemp` project with `lua` feature enabled
and place a `lua.so` or `lua.dll` together with the plugin lua files while bundling
```
.config/
|-nvim/
: |-lua/
: : |-codemp/
: : : |- lua.(so|dll)
: : : |- init.lua
: : : : ...
```